@vintr/node-sdk 1.0.0

package/README.md

@@ -0,0 +1,70 @@
+# @vintr/node-sdk
+
+A minimal, elegant Node.js SDK for the Vintr Alias Resolution API.
+
+## Installation
+
+```bash
+npm install @vintr/node-sdk
+```
+
+## Usage
+
+```typescript
+import { Vintr } from '@vintr/node-sdk';
+
+const vintr = new Vintr('vintr_secret_key');
+
+const location = await vintr.alias.resolve({ alias: 'apple#vintr' });
+```
+
+## API
+
+### `vintr.alias.resolve({ alias })`
+
+Resolves an alias to its associated location and metadata.
+
+**Parameters:**
+- `alias` (string): The alias to resolve in full format with suffix (e.g., `apple#vintr`, `asteik#vintr`, `sushi#vintr`)
+
+**Returns:** `AliasResponse` with location details, coordinates, and delivery instructions.
+
+**Sample Response:**
+```typescript
+{
+  alias: "apple#vintr",
+  type: "business",
+  location: {
+    address: {
+      line1: "1 Apple Park Way",
+      line2: "",
+      line3: "",
+      city: "Cupertino",
+      state: "California",
+      postal_code: "95014",
+      country: "US"
+    },
+    geo: {
+      latitude: 37.335,
+      longitude: -122.0092,
+      altitude: null,
+      precision_meters: 5
+    },
+    instructions: {
+      general: "Enter through the main visitor entrance.",
+      delivery: "Use the designated delivery entrance.",
+      autonomous: "Approach from the east access road."
+    }
+  },
+  createdAt: "2026-08-18T20:39:52.671Z",
+  updatedAt: "2026-08-18T20:39:52.671Z"
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support included with exported types:
+
+```typescript
+import type { AliasResponse, Location, Address, Geo, Instructions } from '@vintr/node-sdk';
+```

package/dist/alias.d.ts

@@ -0,0 +1,7 @@
+import { VintrClient } from './client.js';
+import type { AliasResponse, ResolveAliasParams } from './types.js';
+export declare class AliasAPI {
+    private client;
+    constructor(client: VintrClient);
+    resolve(params: ResolveAliasParams): Promise<AliasResponse>;
+}

package/dist/alias.js

@@ -0,0 +1,8 @@
+export class AliasAPI {
+    constructor(client) {
+        this.client = client;
+    }
+    async resolve(params) {
+        return this.client.resolveAlias(params.alias);
+    }
+}

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { AliasResponse } from './types.js';
+export declare class VintrClient {
+    private apiKey;
+    private readonly baseUrl;
+    constructor(apiKey: string);
+    private request;
+    resolveAlias(alias: string): Promise<AliasResponse>;
+}

package/dist/client.js

@@ -0,0 +1,44 @@
+import https from 'https';
+export class VintrClient {
+    constructor(apiKey) {
+        this.baseUrl = 'https://api.vintr.xyz';
+        this.apiKey = apiKey;
+    }
+    async request(path) {
+        return new Promise((resolve, reject) => {
+            const url = new URL(path, this.baseUrl);
+            const options = {
+                hostname: url.hostname,
+                port: url.port || 443,
+                path: url.pathname,
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+            };
+            const req = https.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => data += chunk);
+                res.on('end', () => {
+                    try {
+                        if (res.statusCode === 200) {
+                            resolve(JSON.parse(data));
+                        }
+                        else {
+                            reject(new Error(`HTTP ${res.statusCode}: ${data}`));
+                        }
+                    }
+                    catch (e) {
+                        reject(new Error(`Failed to parse response: ${data}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.end();
+        });
+    }
+    async resolveAlias(alias) {
+        return this.request(`/${alias}`);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { AliasAPI } from './alias.js';
+export declare class Vintr {
+    readonly alias: AliasAPI;
+    private client;
+    constructor(apiKey: string);
+}
+export type { Address, Geo, Instructions, Location, AliasResponse, ErrorResponse, ResolveAliasParams } from './types.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+import { VintrClient } from './client.js';
+import { AliasAPI } from './alias.js';
+export class Vintr {
+    constructor(apiKey) {
+        this.client = new VintrClient(apiKey);
+        this.alias = new AliasAPI(this.client);
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+export interface Address {
+    line1: string;
+    line2?: string;
+    line3?: string;
+    city: string;
+    state: string;
+    postal_code: string;
+    country: string;
+}
+export interface Geo {
+    latitude: number;
+    longitude: number;
+    altitude: number | null;
+    precision_meters: number;
+}
+export interface Instructions {
+    general: string;
+    delivery: string;
+    autonomous: string;
+}
+export interface Location {
+    address: Address;
+    geo: Geo;
+    instructions: Instructions;
+}
+export interface AliasResponse {
+    alias: string;
+    type: 'business' | 'individual';
+    location: Location;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ErrorResponse {
+    error: string;
+}
+export interface ResolveAliasParams {
+    alias: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@vintr/node-sdk",
+  "version": "1.0.0",
+  "description": "Minimal, elegant Vintr API SDK for Node.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "vintr",
+    "api",
+    "sdk",
+    "alias",
+    "location"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@zelkea/node-sdk": "^1.0.2"
+  }
+}