@opsregistry/adapter-nrgtk 0.0.1

package/README.md

@@ -0,0 +1,19 @@
+# @opsregistry/adapter-nrgtk
+
+Каркас runtime-адаптера для ТК Энергия под кодом `nrgtk`.
+
+Пакет предназначен для будущей реализации универсальных операций `opsregistry` поверх API провайдера.
+
+Что уже есть:
+
+- минимальные Zod-схемы для `delivery.quote` и `delivery.createShipment`;
+- типы входа и выхода этих операций;
+- фабрика `createAdapter(...)`;
+- stub-реализация методов, которая пока явно сообщает, что интеграция не реализована.
+
+Что нужно делать дальше:
+
+1. Уточнить реальные поля входа и выхода по операциям.
+2. Добавить transport и авторизацию провайдера.
+3. Реализовать маппинг ответов провайдера в универсальные структуры.
+4. Покрыть адаптер тестами на нормализацию данных и ошибок.

package/dist/adapter.d.ts

@@ -0,0 +1,12 @@
+import { type AdapterConfig, type CreateShipmentInput, type CreateShipmentResult, type AuthMode, type DeliveryQuoteInput, type DeliveryQuoteResult, providerCode } from './contracts.js';
+export type ProviderAdapter = {
+    providerCode: typeof providerCode;
+    quoteDelivery: (input: DeliveryQuoteInput, options?: {
+        authMode?: AuthMode;
+    }) => Promise<DeliveryQuoteResult>;
+    createShipment: (input: CreateShipmentInput, options?: {
+        authMode?: AuthMode;
+    }) => Promise<CreateShipmentResult>;
+};
+export declare const createAdapter: (config?: AdapterConfig) => ProviderAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,aAAa,EAIlB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAGzB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,YAAY,EAGZ,MAAM,gBAAgB,CAAC;AAsFxB,MAAM,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,aAAa,EAAE,CACd,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,KAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC,cAAc,EAAE,CACf,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,KAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAQ,aAAkB,KAAG,eA+B1D,CAAC"}

package/dist/adapter.js

@@ -0,0 +1,77 @@
+import { adapterConfigSchema, authModeSchema, createShipmentInputSchema, createShipmentOperationCode, deliveryQuoteInputSchema, deliveryQuoteOperationCode, providerCode, supportedCreateShipmentAuthModes, supportedQuoteAuthModes } from './contracts.js';
+const notImplemented = (operationCode) => {
+    throw new Error(`Adapter ${providerCode} does not implement ${operationCode} yet. This package is only a skeleton.`);
+};
+const assertSupportedAuthMode = (operationCode, supportedAuthModes, authMode) => {
+    const resolvedAuthMode = authMode ?? supportedAuthModes[0];
+    authModeSchema.parse(resolvedAuthMode);
+    if (!supportedAuthModes.includes(resolvedAuthMode)) {
+        throw new Error(`Adapter ${providerCode} does not support auth mode ${resolvedAuthMode} for ${operationCode}.`);
+    }
+    return resolvedAuthMode;
+};
+const createTransportContext = (config) => ({
+    timeoutMs: config.timeoutMs,
+    baseUrl: config.baseUrl ?? 'https://api.nrg-tk.ru',
+    apiKey: config.apiKey
+});
+const buildQuoteStubOption = (input, overrides) => ({
+    providerCode,
+    serviceCode: overrides.serviceCode,
+    serviceName: overrides.serviceName,
+    price: overrides.price,
+    currency: 'RUB',
+    etaMinDays: overrides.etaMinDays,
+    etaMaxDays: overrides.etaMaxDays,
+    notes: [
+        `Stub quote for route ${input.origin.city} -> ${input.destination.city}.`,
+        ...(overrides.notes ?? [])
+    ]
+});
+const quoteDeliveryAuthorized = async (transport, input) => ({
+    operationCode: deliveryQuoteOperationCode,
+    accessModeUsed: 'authorized',
+    pricingScope: 'personal',
+    options: [
+        buildQuoteStubOption(input, {
+            serviceCode: input.serviceCodes[0] ?? 'nrgtk-contract',
+            serviceName: 'NRGTK Contract Tariff',
+            price: 1080,
+            etaMinDays: 4,
+            etaMaxDays: 7,
+            notes: [
+                `Uses authorized branch ${transport.baseUrl}.`,
+                'Personal tariff branch is selected in this stub.'
+            ]
+        })
+    ]
+});
+const createShipmentAuthorized = async (transport, input) => {
+    void transport;
+    void input;
+    return notImplemented(`${createShipmentOperationCode} [authorized]`);
+};
+export const createAdapter = (config = {}) => {
+    const resolvedConfig = adapterConfigSchema.parse(config);
+    const transport = createTransportContext(resolvedConfig);
+    return {
+        providerCode,
+        async quoteDelivery(input, options = {}) {
+            deliveryQuoteInputSchema.parse(input);
+            const authMode = assertSupportedAuthMode(deliveryQuoteOperationCode, supportedQuoteAuthModes, options.authMode);
+            if (authMode === 'authorized') {
+                return quoteDeliveryAuthorized(transport, input);
+            }
+            return notImplemented(`${deliveryQuoteOperationCode} [${authMode}]`);
+        },
+        async createShipment(input, options = {}) {
+            createShipmentInputSchema.parse(input);
+            const authMode = assertSupportedAuthMode(createShipmentOperationCode, supportedCreateShipmentAuthModes, options.authMode);
+            if (authMode === 'authorized') {
+                return createShipmentAuthorized(transport, input);
+            }
+            return notImplemented(`${createShipmentOperationCode} [${authMode}]`);
+        }
+    };
+};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EAEnB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAG3B,wBAAwB,EACxB,0BAA0B,EAI1B,YAAY,EACZ,gCAAgC,EAChC,uBAAuB,EACvB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,cAAc,GAAG,CAAC,aAAqB,EAAS,EAAE;IACvD,MAAM,IAAI,KAAK,CACd,WAAW,YAAY,uBAAuB,aAAa,wCAAwC,CACnG,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC/B,aAAqB,EACrB,kBAAuC,EACvC,QAA8B,EAC7B,EAAE;IACH,MAAM,gBAAgB,GAAG,QAAQ,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACvC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACd,WAAW,YAAY,+BAA+B,gBAAgB,QAAQ,aAAa,GAAG,CAC9F,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAA6B,EAAE,EAAE,CAAC,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,uBAAuB;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM;CACrB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAC5B,KAAyB,EACzB,SAOC,EACA,EAAE,CAAC,CAAC;IACL,YAAY;IACZ,WAAW,EAAE,SAAS,CAAC,WAAW;IAClC,WAAW,EAAE,SAAS,CAAC,WAAW;IAClC,KAAK,EAAE,SAAS,CAAC,KAAK;IACtB,QAAQ,EAAE,KAAc;IACxB,UAAU,EAAE,SAAS,CAAC,UAAU;IAChC,UAAU,EAAE,SAAS,CAAC,UAAU;IAChC,KAAK,EAAE;QACN,wBAAwB,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,GAAG;QACzE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;KAC1B;CACD,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,KAAK,EACpC,SAAoD,EACpD,KAAyB,EACM,EAAE,CAAC,CAAC;IACnC,aAAa,EAAE,0BAA0B;IACzC,cAAc,EAAE,YAAY;IAC5B,YAAY,EAAE,UAAU;IACxB,OAAO,EAAE;QACR,oBAAoB,CAAC,KAAK,EAAE;YAC3B,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,gBAAgB;YACtD,WAAW,EAAE,uBAAuB;YACpC,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,KAAK,EAAE;gBACN,0BAA0B,SAAS,CAAC,OAAO,GAAG;gBAC9C,kDAAkD;aAClD;SACD,CAAC;KACF;CACD,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,KAAK,EACrC,SAAoD,EACpD,KAA0B,EACM,EAAE;IAClC,KAAK,SAAS,CAAC;IACf,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,CAAC,GAAG,2BAA2B,eAAe,CAAC,CAAC;AACtE,CAAC,CAAC;AAcF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAwB,EAAE,EAAmB,EAAE;IAC5E,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAEzD,OAAO;QACN,YAAY;QACZ,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;YACtC,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,uBAAuB,CACvC,0BAA0B,EAC1B,uBAAuB,EACvB,OAAO,CAAC,QAAQ,CAChB,CAAC;YACF,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC/B,OAAO,uBAAuB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,cAAc,CAAC,GAAG,0BAA0B,KAAK,QAAQ,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;YACvC,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,uBAAuB,CACvC,2BAA2B,EAC3B,gCAAgC,EAChC,OAAO,CAAC,QAAQ,CAChB,CAAC;YACF,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC/B,OAAO,wBAAwB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,cAAc,CAAC,GAAG,2BAA2B,KAAK,QAAQ,GAAG,CAAC,CAAC;QACvE,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/contracts.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { createShipmentInputSchema, createShipmentResultSchema, type CreateShipmentInput, type CreateShipmentResult, operationCode as createShipmentOperationCode } from '@opsregistry/contracts/delivery/create-shipment';
+import { deliveryQuoteInputSchema, deliveryQuoteResultSchema, type DeliveryQuoteInput, type DeliveryQuoteResult, operationCode as deliveryQuoteOperationCode } from '@opsregistry/contracts/delivery/quote';
+export declare const providerCode: "nrgtk";
+export declare const authModeSchema: z.ZodEnum<{
+    public: "public";
+    authorized: "authorized";
+}>;
+export declare const supportedQuoteAuthModes: readonly ["authorized"];
+export declare const supportedCreateShipmentAuthModes: readonly ["authorized"];
+export declare const adapterConfigSchema: z.ZodObject<{
+    baseUrl: z.ZodOptional<z.ZodURL>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export { createShipmentInputSchema, createShipmentResultSchema, deliveryQuoteInputSchema, deliveryQuoteResultSchema };
+export { createShipmentOperationCode, deliveryQuoteOperationCode };
+export type AdapterConfig = z.input<typeof adapterConfigSchema>;
+export type AuthMode = z.infer<typeof authModeSchema>;
+export type { CreateShipmentInput, CreateShipmentResult, DeliveryQuoteInput, DeliveryQuoteResult };
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,aAAa,IAAI,2BAA2B,EAC5C,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,aAAa,IAAI,0BAA0B,EAC3C,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAC7C,eAAO,MAAM,cAAc;;;EAAmC,CAAC;AAC/D,eAAO,MAAM,uBAAuB,yBAA0B,CAAC;AAC/D,eAAO,MAAM,gCAAgC,yBAA0B,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,CAAC;AACtH,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/contracts.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { createShipmentInputSchema, createShipmentResultSchema, operationCode as createShipmentOperationCode } from '@opsregistry/contracts/delivery/create-shipment';
+import { deliveryQuoteInputSchema, deliveryQuoteResultSchema, operationCode as deliveryQuoteOperationCode } from '@opsregistry/contracts/delivery/quote';
+export const providerCode = 'nrgtk';
+export const authModeSchema = z.enum(['public', 'authorized']);
+export const supportedQuoteAuthModes = ['authorized'];
+export const supportedCreateShipmentAuthModes = ['authorized'];
+export const adapterConfigSchema = z.object({
+    baseUrl: z.url().optional(),
+    apiKey: z.string().min(1).optional(),
+    timeoutMs: z.number().int().positive().default(30_000)
+});
+export { createShipmentInputSchema, createShipmentResultSchema, deliveryQuoteInputSchema, deliveryQuoteResultSchema };
+export { createShipmentOperationCode, deliveryQuoteOperationCode };
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACN,yBAAyB,EACzB,0BAA0B,EAG1B,aAAa,IAAI,2BAA2B,EAC5C,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EAGzB,aAAa,IAAI,0BAA0B,EAC3C,MAAM,uCAAuC,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,CAAU,CAAC;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,YAAY,CAAU,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CACtD,CAAC,CAAC;AAEH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,CAAC;AACtH,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './adapter.js';
+export * from './contracts.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,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './adapter.js';
+export * from './contracts.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+	"name": "@opsregistry/adapter-nrgtk",
+	"version": "0.0.1",
+	"description": "Runtime adapter skeleton for mapping NRGTK APIs to opsregistry delivery operations.",
+	"type": "module",
+	"license": "MIT",
+	"packageManager": "bun@1.3.13",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"check": "tsc -p tsconfig.json --noEmit"
+	},
+	"dependencies": {
+		"@opsregistry/contracts": "https://registry.npmjs.org/@opsregistry/contracts/-/contracts-0.0.1.tgz",
+		"zod": "^4.4.3"
+	},
+	"devDependencies": {
+		"typescript": "^6.0.3"
+	}
+}