@uveysservetoglu/kobil-sign 2.0.0 → 3.0.1

package/README.md

@@ -1,6 +1,8 @@
 # @uveysservetoglu/kobil-sign
 
-KOBIL digital signature client for Node.js / TypeScript, with automatic OAuth token management.
+KOBIL PDF signature client for Node.js / TypeScript — the MiniApp API's
+`/v1/messages/sendPdfSignature` (default) or the legacy mPower signature API — with automatic OAuth
+token management.
 
 ```bash
 npm install @uveysservetoglu/kobil-sign
@@ -9,8 +11,8 @@ npm install @uveysservetoglu/kobil-sign
 ```ts
 import { SignClient } from "@uveysservetoglu/kobil-sign";
 
-// OIDC_ISSUER, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, MPOWER_BASE and MPOWER_TENANT come from
-// the environment; only the callback is app-specific.
+// OIDC_ISSUER, OIDC_CLIENT_ID and OIDC_CLIENT_SECRET (+ MPOWER_BASE, MPOWER_TENANT in legacy mode)
+// come from the environment; only the callback is app-specific.
 const sign = new SignClient({
   defaultCallbackUrl: "https://yourapi.com/signature-callback",
 });
@@ -22,36 +24,60 @@ const res = await sign.initiatePdfSignature({
   messageText: "Please sign here",
   position: { pageNumber: 1, bottomLeftX: 59, bottomLeftY: 89, topRightX: 85, topRightY: 96 },
 });
-// res.messageId, res.instanceId
+// res.messageId, plus res.createdAt and res.file (miniapp) or res.instanceId (legacy)
 ```
 
-`{TENANT}` is filled from `tenantName`, `{USER_ID}` from the call; `/signature` is appended.
+## Where the signature goes
 
-## Environment
+The two APIs describe the signature box differently. Either form works in either mode — the client
+converts it:
 
-| Variable | Meaning |
-|---|---|
-| `OIDC_ISSUER` | Realm issuer URL; the token endpoint is derived from it. |
-| `OIDC_CLIENT_ID` / `OIDC_CLIENT_SECRET` | Client credentials. The id is also the default `serviceUuid`. |
-| `MPOWER_BASE` | mPower origin — signing shares it with chat. `{base}/auth/realms/{TENANT}/mpower/v1/users/{USER_ID}` is derived from it. |
-| `MPOWER_TENANT` | Tenant/realm substituted for `{TENANT}`. |
+| Form | Units | Origin | Fields |
+|---|---|---|---|
+| `SignaturePosition` (legacy) | **integer percent** of the page, 0–100 | bottom-left | `pageNumber`, `bottomLeftX/Y`, `topRightX/Y` |
+| `SignatureArea` (MiniApp) | fraction of the page, 0.0–1.0 | top-left | `page`, `left`, `top`, `width`, `height` |
 
-Pass `signBaseUrl` or `tenantName` to override. These are the names the SuperApp emulator publishes at
-`/__superapp/control/env`.
+They are not PDF points. `toSignatureArea` / `toSignaturePosition` convert explicitly; legacy mode
+rounds to whole percentages, because the legacy platform rejects anything else.
 
-### How it maps to the API
+**Several signers (miniapp mode):** pass `signatures` instead of `position` — 1–20 fields, each with
+its own `signeeUserId` (default: `userId`):
 
-`POST {signBaseUrl}/signature` as `multipart/form-data`:
+```ts
+await sign.initiatePdfSignature({
+  userId,
+  file: pdfBytes,
+  messageText: "Please both sign",
+  signatures: [
+    { position: { page: 1, left: 0.1, top: 0.85, width: 0.3, height: 0.06 } },
+    { signeeUserId: otherUserId, position: { page: 1, left: 0.6, top: 0.85, width: 0.3, height: 0.06 } },
+  ],
+});
+```
+
+Legacy mode takes exactly one field, signed by `userId`.
+
+## API mode
+
+Leave `apiMode` unset (or `KOBIL_API_MODE` empty) for the MiniApp API; pass `"legacy"` for mPower.
+See `@uveysservetoglu/kobil-core` for the shared settings.
+
+| | Miniapp (default) | Legacy |
+|---|---|---|
+| Request | `POST /v1/messages/sendPdfSignature`, multipart `file` + JSON `message` | `POST {signBaseUrl}/signature`, multipart `signatureFile` + `signatureData` |
+| `messageText` | required | optional |
+| Callback | optional — omit for the MiniApp's global callback | `callbackUrl` / `defaultCallbackUrl` |
+| Push | `push` bundled with the request | ignored |
 
-- `signatureFile` — the PDF bytes (`application/pdf`)
-- `signatureData` — JSON: `version`, `pageNumber`, `bottomLeft*/topRight*Coordinate`,
-  `serviceUuid`, `messageText`, `callbackUrl`
+Legacy mode only: the endpoint is derived from `MPOWER_BASE`
+(`{base}/auth/realms/{TENANT}/mpower/v1/users/{USER_ID}`, with `/signature` appended); `{TENANT}` is
+filled from `tenantName` (`MPOWER_TENANT`). Pass `signBaseUrl` or `tenantName` to override.
 
-The signed PDF is delivered to your callback as a `signatureResponse`; download it by its
-`mediaId` using `@uveysservetoglu/kobil-chat`'s `getAttachmentFile`.
+The signed PDF is delivered to your callback; download it by its `mediaId` using
+`@uveysservetoglu/kobil-chat`'s `getAttachmentFile`.
 
 JavaScript usage is identical (`const { SignClient } = require("@uveysservetoglu/kobil-sign")`).
-Failures throw `KobilSignError` (extends `KobilError`).
+Failures reject with `KobilSignError` (extends `KobilError`).
 
 ## License
 

package/dist/client.d.ts

@@ -1,23 +1,28 @@
-import { KobilCredentials, KobilError, KobilServiceClient, TokenProvider } from "@uveysservetoglu/kobil-core";
+import { ApiMode, KobilApiOptions, KobilCredentials, KobilError, KobilServiceClient, TokenProvider } from "@uveysservetoglu/kobil-core";
 import { InitiateSignatureInput, SignatureResult } from "./types";
-export interface SignClientOptions extends Partial<KobilCredentials> {
+export interface SignClientOptions extends Partial<KobilCredentials>, KobilApiOptions {
     /**
-     * Signature endpoint template up to the user segment, with {TENANT} and {USER_ID}.
+     * Legacy mode: signature endpoint template up to the user segment, with {TENANT} and {USER_ID}.
      * Derived from `MPOWER_BASE` when omitted — signing and chat share the same host.
      */
     signBaseUrl?: string;
-    /** Tenant/realm name substituted for {TENANT}. Falls back to `MPOWER_TENANT`. */
+    /** Legacy mode: tenant/realm name substituted for {TENANT}. Falls back to `MPOWER_TENANT`. */
     tenantName?: string;
-    /** serviceUuid sent with the request. Optional: defaults to clientId. */
+    /** Legacy mode: serviceUuid sent with the request. Optional: defaults to clientId. */
     serviceUuid?: string;
     /** Default callback URL for signature results; overridable per request. */
     defaultCallbackUrl?: string;
-    /** Wire protocol version. Default: 3. */
+    /** Legacy mode: wire protocol version. Default: 3. */
     version?: number;
     tokenProvider?: TokenProvider;
 }
-/** Client for the KOBIL digital signature API. */
+/**
+ * Client for KOBIL PDF signing: the MiniApp API's `/v1/messages/sendPdfSignature` (default) or the
+ * legacy mPower signature API.
+ */
 export declare class SignClient extends KobilServiceClient {
+    readonly apiMode: ApiMode;
+    private readonly apiBase;
     private readonly signBaseUrl;
     private readonly tenantName?;
     private readonly clientId;
@@ -26,6 +31,10 @@ export declare class SignClient extends KobilServiceClient {
     private readonly version;
     constructor(options?: SignClientOptions);
     protected makeError(message: string, statusCode?: number, responseBody?: string, cause?: unknown): KobilError;
+    /**
+     * Asks the user to sign a PDF. The signed document is delivered to the callback; download it by its
+     * `mediaId` with `@uveysservetoglu/kobil-chat`'s `getAttachmentFile`.
+     */
     initiatePdfSignature(input: InitiateSignatureInput, signal?: AbortSignal): Promise<SignatureResult>;
     private signatureUrl;
     private serviceUuid;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,aAAa,EAGd,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAClE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,kDAAkD;AAClD,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,iBAAsB;cAsBxB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU;IAItH,oBAAoB,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBnG,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;CAGpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,aAAa,EAKd,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,sBAAsB,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC;AAElF,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,gBAAgB,CAAC,EAAE,eAAe;IACnF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,iBAAsB;cAiCxB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU;IAItH;;;OAGG;IACG,oBAAoB,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDzG,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/client.js

@@ -3,8 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignClient = void 0;
 const kobil_core_1 = require("@uveysservetoglu/kobil-core");
 const error_1 = require("./error");
-/** Client for the KOBIL digital signature API. */
+const position_1 = require("./position");
+/**
+ * Client for KOBIL PDF signing: the MiniApp API's `/v1/messages/sendPdfSignature` (default) or the
+ * legacy mPower signature API.
+ */
 class SignClient extends kobil_core_1.KobilServiceClient {
+    apiMode;
+    apiBase;
     signBaseUrl;
     tenantName;
     clientId;
@@ -12,6 +18,7 @@ class SignClient extends kobil_core_1.KobilServiceClient {
     defaultCallbackUrl;
     version;
     constructor(options = {}) {
+        const apiMode = (0, kobil_core_1.resolveApiMode)(options.apiMode);
         const credentials = (0, kobil_core_1.credentialsFromEnv)({
             tokenEndpoint: options.tokenEndpoint,
             clientId: options.clientId,
@@ -19,12 +26,20 @@ class SignClient extends kobil_core_1.KobilServiceClient {
             tokenAuthMode: options.tokenAuthMode,
             defaultTokenTtlSeconds: options.defaultTokenTtlSeconds,
             tokenExpirySkewSeconds: options.tokenExpirySkewSeconds,
-        });
+        }, { apiMode, apiBaseUrl: options.apiBaseUrl, realm: options.realm });
         super(options.tokenProvider ?? new kobil_core_1.DefaultTokenProvider(credentials));
-        const signBaseUrl = options.signBaseUrl || (0, kobil_core_1.mpowerUserEndpoint)(process.env.MPOWER_BASE);
-        if (!signBaseUrl)
-            throw new kobil_core_1.KobilError("No signature endpoint: set MPOWER_BASE (or pass signBaseUrl).");
-        this.signBaseUrl = signBaseUrl;
+        this.apiMode = apiMode;
+        if (apiMode === "legacy") {
+            const signBaseUrl = options.signBaseUrl || (0, kobil_core_1.mpowerUserEndpoint)(process.env.MPOWER_BASE);
+            if (!signBaseUrl)
+                throw new kobil_core_1.KobilError("No signature endpoint: set MPOWER_BASE (or pass signBaseUrl).");
+            this.signBaseUrl = signBaseUrl;
+            this.apiBase = "";
+        }
+        else {
+            this.signBaseUrl = "";
+            this.apiBase = (0, kobil_core_1.miniappApiBase)(options.apiBaseUrl);
+        }
         this.tenantName = options.tenantName ?? process.env.MPOWER_TENANT;
         this.clientId = credentials.clientId;
         this.serviceUuidOption = options.serviceUuid;
@@ -34,12 +49,45 @@ class SignClient extends kobil_core_1.KobilServiceClient {
     makeError(message, statusCode, responseBody, cause) {
         return new error_1.KobilSignError(message, { statusCode, responseBody, cause });
     }
-    initiatePdfSignature(input, signal) {
+    /**
+     * Asks the user to sign a PDF. The signed document is delivered to the callback; download it by its
+     * `mediaId` with `@uveysservetoglu/kobil-chat`'s `getAttachmentFile`.
+     */
+    async initiatePdfSignature(input, signal) {
         if (!input.userId)
             throw new error_1.KobilSignError("userId cannot be empty.");
         if (!input.file || input.file.length === 0)
             throw new error_1.KobilSignError("file (PDF) cannot be empty.");
-        const p = input.position;
+        const fields = signatureFields(input);
+        const callbackUrl = input.callbackUrl ?? this.defaultCallbackUrl;
+        if (this.apiMode === "miniapp") {
+            if (!input.messageText)
+                throw new error_1.KobilSignError("messageText is required in miniapp mode.");
+            if (fields.length > 20)
+                throw new error_1.KobilSignError(`The MiniApp API takes at most 20 signatures, got ${fields.length}.`);
+            const message = prune({
+                userId: input.userId,
+                text: input.messageText,
+                signature: fields.map((f) => ({
+                    signeeUserId: f.signeeUserId ?? input.userId,
+                    position: (0, position_1.toSignatureArea)(f.position),
+                })),
+                callbackUrl,
+                push: input.push,
+            });
+            return this.sendMultipart("POST", `${this.apiBase}/v1/messages/sendPdfSignature`, [
+                { name: "file", value: input.file, fileName: input.fileName ?? "document.pdf", contentType: "application/pdf" },
+                { name: "message", value: JSON.stringify(message), contentType: "application/json" },
+            ], signal);
+        }
+        if (fields.length !== 1) {
+            throw new error_1.KobilSignError("Legacy mode takes exactly one signature field: pass position (or one signature).");
+        }
+        const field = fields[0];
+        if (field.signeeUserId !== undefined && field.signeeUserId !== input.userId) {
+            throw new error_1.KobilSignError("Legacy mode cannot name a different signee: the recipient (userId) signs.");
+        }
+        const p = (0, position_1.toSignaturePosition)(field.position);
         const signatureData = {
             version: this.version,
             pageNumber: p.pageNumber ?? 1,
@@ -49,7 +97,7 @@ class SignClient extends kobil_core_1.KobilServiceClient {
             topRightYCoordinate: p.topRightY,
             serviceUuid: this.serviceUuid(),
             messageText: input.messageText,
-            callbackUrl: input.callbackUrl ?? this.defaultCallbackUrl,
+            callbackUrl,
         };
         const form = new FormData();
         form.append("signatureFile", new Blob([input.file], { type: "application/pdf" }), input.fileName ?? "document.pdf");
@@ -65,6 +113,17 @@ class SignClient extends kobil_core_1.KobilServiceClient {
     }
 }
 exports.SignClient = SignClient;
+/** The fields to sign: `signatures` if given, else the single `position`. */
+function signatureFields(input) {
+    if (input.signatures && input.signatures.length > 0) {
+        if (input.position)
+            throw new error_1.KobilSignError("Pass either position or signatures, not both.");
+        return input.signatures;
+    }
+    if (!input.position)
+        throw new error_1.KobilSignError("A signature position is required: pass position (or signatures).");
+    return [{ position: input.position }];
+}
 function replaceTokens(template, tokens) {
     let result = template;
     for (const [token, value] of Object.entries(tokens)) {
@@ -72,4 +131,13 @@ function replaceTokens(template, tokens) {
     }
     return result;
 }
+/** Removes undefined/null properties so optional fields are omitted from the JSON body. */
+function prune(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined && value !== null)
+            out[key] = value;
+    }
+    return out;
+}
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { SignClient } from "./client";
 export type { SignClientOptions } from "./client";
 export { KobilSignError } from "./error";
-export type { InitiateSignatureInput, SignaturePosition, SignatureResult } from "./types";
+export { toSignatureArea, toSignaturePosition } from "./position";
+export type { InitiateSignatureInput, SignatureArea, SignatureField, SignatureFileMetadata, SignaturePosition, SignatureResult, } from "./types";
+export type { PushContent, PushResponse } from "@uveysservetoglu/kobil-core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KobilSignError = exports.SignClient = void 0;
+exports.toSignaturePosition = exports.toSignatureArea = exports.KobilSignError = exports.SignClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "SignClient", { enumerable: true, get: function () { return client_1.SignClient; } });
 var error_1 = require("./error");
 Object.defineProperty(exports, "KobilSignError", { enumerable: true, get: function () { return error_1.KobilSignError; } });
+var position_1 = require("./position");
+Object.defineProperty(exports, "toSignatureArea", { enumerable: true, get: function () { return position_1.toSignatureArea; } });
+Object.defineProperty(exports, "toSignaturePosition", { enumerable: true, get: function () { return position_1.toSignaturePosition; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAEnB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAEnB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA;AACvB,uCAAkE;AAAzD,2GAAA,eAAe,OAAA;AAAE,+GAAA,mBAAmB,OAAA"}

package/dist/position.d.ts

@@ -0,0 +1,17 @@
+import { SignatureArea, SignaturePosition } from "./types";
+/**
+ * Conversions between the two APIs' signature rectangles. Both describe the same box relative to the
+ * page, so nothing about the PDF itself is needed:
+ *
+ * - legacy: integer percentages, origin bottom-left — `bottomLeftX/Y`, `topRightX/Y`
+ * - miniapp: fractions, origin top-left — `left`, `top`, `width`, `height`
+ */
+export declare function isSignatureArea(position: SignaturePosition | SignatureArea): position is SignatureArea;
+/** As a MiniApp API area. Areas pass through untouched. */
+export declare function toSignatureArea(position: SignaturePosition | SignatureArea): SignatureArea;
+/**
+ * As a legacy rectangle. Rounded to whole percentages: the legacy platform parses the coordinates as
+ * integers and rejects anything else.
+ */
+export declare function toSignaturePosition(position: SignaturePosition | SignatureArea): SignaturePosition;
+//# sourceMappingURL=position.d.ts.map

package/dist/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../src/position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;GAMG;AAEH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,GAAG,QAAQ,IAAI,aAAa,CAEtG;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,GAAG,aAAa,CAS1F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,GAAG,iBAAiB,CASlG"}

package/dist/position.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSignatureArea = isSignatureArea;
+exports.toSignatureArea = toSignatureArea;
+exports.toSignaturePosition = toSignaturePosition;
+/**
+ * Conversions between the two APIs' signature rectangles. Both describe the same box relative to the
+ * page, so nothing about the PDF itself is needed:
+ *
+ * - legacy: integer percentages, origin bottom-left — `bottomLeftX/Y`, `topRightX/Y`
+ * - miniapp: fractions, origin top-left — `left`, `top`, `width`, `height`
+ */
+function isSignatureArea(position) {
+    return "left" in position;
+}
+/** As a MiniApp API area. Areas pass through untouched. */
+function toSignatureArea(position) {
+    if (isSignatureArea(position))
+        return position;
+    return {
+        page: position.pageNumber ?? 1,
+        left: fraction(position.bottomLeftX),
+        top: fraction(100 - position.topRightY),
+        width: fraction(position.topRightX - position.bottomLeftX),
+        height: fraction(position.topRightY - position.bottomLeftY),
+    };
+}
+/**
+ * As a legacy rectangle. Rounded to whole percentages: the legacy platform parses the coordinates as
+ * integers and rejects anything else.
+ */
+function toSignaturePosition(position) {
+    if (!isSignatureArea(position))
+        return position;
+    return {
+        pageNumber: position.page,
+        bottomLeftX: Math.round(position.left * 100),
+        bottomLeftY: Math.round((1 - position.top - position.height) * 100),
+        topRightX: Math.round((position.left + position.width) * 100),
+        topRightY: Math.round((1 - position.top) * 100),
+    };
+}
+/** Percent → fraction, without the float noise (`0.59` rather than `0.5900000000000001`). */
+function fraction(percent) {
+    return Math.round(percent * 1e4) / 1e6;
+}
+//# sourceMappingURL=position.js.map

package/dist/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../src/position.ts"],"names":[],"mappings":";;AAUA,0CAEC;AAGD,0CASC;AAMD,kDASC;AArCD;;;;;;GAMG;AAEH,SAAgB,eAAe,CAAC,QAA2C;IACzE,OAAO,MAAM,IAAI,QAAQ,CAAC;AAC5B,CAAC;AAED,2DAA2D;AAC3D,SAAgB,eAAe,CAAC,QAA2C;IACzE,IAAI,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC;QAC9B,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;QACpC,GAAG,EAAE,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC;QACvC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC;QAC1D,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,QAA2C;IAC7E,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,IAAI;QACzB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC;QAC5C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;QACnE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;QAC7D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,8 @@
-/** Rectangle (in PDF points) where the signature is placed on a page. */
+import type { PushContent, PushResponse } from "@uveysservetoglu/kobil-core";
+/**
+ * Signature rectangle in the legacy API's coordinates: **integer percentages (0–100) of the page,
+ * origin bottom-left**. Accepted in both modes — miniapp mode converts it to a {@link SignatureArea}.
+ */
 export interface SignaturePosition {
     /** 1-based page number. Default: 1. */
     pageNumber?: number;
@@ -7,21 +11,63 @@ export interface SignaturePosition {
     topRightX: number;
     topRightY: number;
 }
+/**
+ * Signature rectangle in the MiniApp API's coordinates: **fractions (0.0–1.0) of the page, origin
+ * top-left** (x to the right, y down). Accepted in both modes — legacy mode converts it to rounded
+ * percentages.
+ */
+export interface SignatureArea {
+    /** 1-based page number. */
+    page: number;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** One signature field and who signs it. */
+export interface SignatureField {
+    /** The user who signs this field. Default: the request's `userId`. */
+    signeeUserId?: string;
+    position: SignaturePosition | SignatureArea;
+}
 export interface InitiateSignatureInput {
+    /** Recipient of the signature request. */
     userId: string;
-    /** Raw PDF bytes to be signed. */
+    /** Raw PDF bytes to be signed. Max 10 MB in miniapp mode. */
     file: Uint8Array;
     /** File name for the upload part. Default: "document.pdf". */
     fileName?: string;
-    /** Prompt shown to the signer. */
+    /** Prompt shown to the signer. Required in miniapp mode. */
     messageText?: string;
-    /** Callback URL for the signature result. Falls back to the configured default. */
+    /**
+     * Where the signed result is delivered. Falls back to the configured default; in miniapp mode, omit
+     * both to use the MiniApp's global callback.
+     */
     callbackUrl?: string;
-    position: SignaturePosition;
+    /** The single field `userId` signs. Give this or `signatures`. */
+    position?: SignaturePosition | SignatureArea;
+    /** Several fields and/or signers (1–20). Miniapp mode only; legacy mode takes exactly one, signed by `userId`. */
+    signatures?: SignatureField[];
+    /** Miniapp mode: push notification bundled with the request. Ignored in legacy mode. */
+    push?: PushContent;
+}
+/** File details the MiniApp API returns for the uploaded PDF. */
+export interface SignatureFileMetadata {
+    mediaId: string;
+    fileName: string;
+    contentType: string;
+    fileSize: number;
 }
 export interface SignatureResult {
     messageId?: string;
+    /** Legacy mode. */
     instanceId?: string;
+    /** Miniapp mode: when the request was created (ISO 8601). */
+    createdAt?: string;
+    /** Miniapp mode: the uploaded PDF. */
+    file?: SignatureFileMetadata;
+    /** Miniapp mode: outcome of the bundled push, when one was sent. */
+    push?: PushResponse;
     [key: string]: unknown;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,UAAU,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAC7C,kHAAkH;IAClH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,wFAAwF;IACxF,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,oEAAoE;IACpE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uveysservetoglu/kobil-sign",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "KOBIL digital signature client for Node.js: initiate PDF signatures with automatic OAuth token management.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "url": "https://github.com/uveysservetoglu/kobil-sdks"
   },
   "dependencies": {
-    "@uveysservetoglu/kobil-core": "^2.0.0"
+    "@uveysservetoglu/kobil-core": "^3.0.0"
   },
   "scripts": {
     "build": "tsc -b"