inklok-sdk-node 0.1.6 → 0.1.8

package/dist/client.d.ts

@@ -3,12 +3,24 @@
  * Each method delegates to one endpoint module for scalability and testability.
  */
 import type { components } from "./types";
+import * as documents from "./endpoints/documents";
 import * as orkMetadata from "./endpoints/ork-metadata";
 import * as orgMembers from "./endpoints/org-members";
 import * as meOrgs from "./endpoints/me-orgs";
+export type DocumentMetadata = components["schemas"]["DocumentMetadata"];
 export type OrkMetadata = components["schemas"]["OrkMetadata"];
 export type OrgMember = components["schemas"]["OrgMember"];
 export type MeOrg = components["schemas"]["MeOrg"];
+export type CreateDocumentV1Params = documents.CreateDocumentV1Params;
+export type CreateDocumentV1Response = documents.CreateDocumentV1Response;
+export type ListDocumentsV1Params = documents.ListDocumentsV1Params;
+export type ListDocumentsV1Response = documents.ListDocumentsV1Response;
+export type GetDocumentV1Params = documents.GetDocumentV1Params;
+export type GetDocumentV1Response = documents.GetDocumentV1Response;
+export type UploadDocumentV1Params = documents.UploadDocumentV1Params;
+export type UploadDocumentV1Response = documents.UploadDocumentV1Response;
+export type DeleteDocumentV1Params = documents.DeleteDocumentV1Params;
+export type DeleteDocumentV1Response = documents.DeleteDocumentV1Response;
 export type ListOrkMetadataV1Params = orkMetadata.ListOrkMetadataV1Params;
 export type ListOrkMetadataV1Response = orkMetadata.ListOrkMetadataV1Response;
 export type ListOrgMembersV1Params = orgMembers.ListOrgMembersV1Params;
@@ -34,4 +46,14 @@ export declare class InklokClient {
      * GET /me/orgs - list organizations for the current user.
      */
     listMeOrgs(params: ListMeOrgsParams): Promise<ListMeOrgsResponse>;
+    /** POST /v1/documents - create document record (metadata only, draft). */
+    createDocumentV1(params: CreateDocumentV1Params): Promise<CreateDocumentV1Response>;
+    /** GET /v1/documents - list documents for the org. */
+    listDocumentsV1(params: ListDocumentsV1Params): Promise<ListDocumentsV1Response>;
+    /** GET /v1/documents/{documentId} - get one document metadata. */
+    getDocumentV1(params: GetDocumentV1Params): Promise<GetDocumentV1Response>;
+    /** POST /v1/documents/{documentId}/upload - upload PDF (encrypted bytes); finalizes material document. */
+    uploadDocumentV1(params: UploadDocumentV1Params): Promise<UploadDocumentV1Response>;
+    /** DELETE /v1/documents/{documentId} - delete document (metadata and object). */
+    deleteDocumentV1(params: DeleteDocumentV1Params): Promise<void>;
 }

package/dist/client.js

@@ -38,6 +38,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InklokClient = void 0;
+const documents = __importStar(require("./endpoints/documents"));
 const orkMetadata = __importStar(require("./endpoints/ork-metadata"));
 const orgMembers = __importStar(require("./endpoints/org-members"));
 const meOrgs = __importStar(require("./endpoints/me-orgs"));
@@ -64,5 +65,25 @@ class InklokClient {
     async listMeOrgs(params) {
         return meOrgs.listMeOrgs(this.baseUrl, params);
     }
+    /** POST /v1/documents - create document record (metadata only, draft). */
+    async createDocumentV1(params) {
+        return documents.createDocumentV1(this.baseUrl, params);
+    }
+    /** GET /v1/documents - list documents for the org. */
+    async listDocumentsV1(params) {
+        return documents.listDocumentsV1(this.baseUrl, params);
+    }
+    /** GET /v1/documents/{documentId} - get one document metadata. */
+    async getDocumentV1(params) {
+        return documents.getDocumentV1(this.baseUrl, params);
+    }
+    /** POST /v1/documents/{documentId}/upload - upload PDF (encrypted bytes); finalizes material document. */
+    async uploadDocumentV1(params) {
+        return documents.uploadDocumentV1(this.baseUrl, params);
+    }
+    /** DELETE /v1/documents/{documentId} - delete document (metadata and object). */
+    async deleteDocumentV1(params) {
+        return documents.deleteDocumentV1(this.baseUrl, params);
+    }
 }
 exports.InklokClient = InklokClient;

package/dist/endpoints/documents.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Document lifecycle v1 endpoints: create, list, get, upload.
+ * All require Bearer JWT and X-Inklok-Org-Id (orgId in params).
+ */
+import type { components, operations } from "../types";
+export type DocumentMetadata = components["schemas"]["DocumentMetadata"];
+export type CreateDocumentV1Response = operations["createDocumentV1"]["responses"]["201"]["content"]["application/json"];
+export type ListDocumentsV1Response = operations["listDocumentsV1"]["responses"]["200"]["content"]["application/json"];
+export type GetDocumentV1Response = operations["getDocumentV1"]["responses"]["200"]["content"]["application/json"];
+export type UploadDocumentV1Response = operations["uploadDocumentV1"]["responses"]["200"]["content"]["application/json"];
+export type DeleteDocumentV1Response = operations["deleteDocumentV1"]["responses"]["204"];
+export interface CreateDocumentV1Params {
+    orgId: string;
+    accessToken: string;
+    /** Optional metadata (implementation in _core). */
+    body?: Record<string, unknown>;
+}
+export interface ListDocumentsV1Params {
+    orgId: string;
+    accessToken: string;
+}
+export interface GetDocumentV1Params {
+    documentId: string;
+    orgId: string;
+    accessToken: string;
+}
+export interface UploadDocumentV1Params {
+    documentId: string;
+    orgId: string;
+    accessToken: string;
+    /** Encrypted PDF bytes (opaque to infra). */
+    body: ArrayBuffer | Uint8Array;
+}
+export interface DeleteDocumentV1Params {
+    documentId: string;
+    orgId: string;
+    accessToken: string;
+}
+export declare function createDocumentV1(baseUrl: string, params: CreateDocumentV1Params): Promise<CreateDocumentV1Response>;
+export declare function listDocumentsV1(baseUrl: string, params: ListDocumentsV1Params): Promise<ListDocumentsV1Response>;
+export declare function getDocumentV1(baseUrl: string, params: GetDocumentV1Params): Promise<GetDocumentV1Response>;
+export declare function uploadDocumentV1(baseUrl: string, params: UploadDocumentV1Params): Promise<UploadDocumentV1Response>;
+export declare function deleteDocumentV1(baseUrl: string, params: DeleteDocumentV1Params): Promise<void>;

package/dist/endpoints/documents.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Document lifecycle v1 endpoints: create, list, get, upload.
+ * All require Bearer JWT and X-Inklok-Org-Id (orgId in params).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDocumentV1 = createDocumentV1;
+exports.listDocumentsV1 = listDocumentsV1;
+exports.getDocumentV1 = getDocumentV1;
+exports.uploadDocumentV1 = uploadDocumentV1;
+exports.deleteDocumentV1 = deleteDocumentV1;
+const http_1 = require("../http");
+const base = (url) => url.replace(/\/$/, "");
+async function createDocumentV1(baseUrl, params) {
+    const url = `${base(baseUrl)}/v1/documents`;
+    return (0, http_1.postAuthenticated)(url, {
+        accessToken: params.accessToken,
+        orgId: params.orgId,
+    }, params.body);
+}
+async function listDocumentsV1(baseUrl, params) {
+    const url = `${base(baseUrl)}/v1/documents`;
+    return (0, http_1.getAuthenticated)(url, {
+        accessToken: params.accessToken,
+        orgId: params.orgId,
+    });
+}
+async function getDocumentV1(baseUrl, params) {
+    const url = `${base(baseUrl)}/v1/documents/${encodeURIComponent(params.documentId)}`;
+    return (0, http_1.getAuthenticated)(url, {
+        accessToken: params.accessToken,
+        orgId: params.orgId,
+    });
+}
+async function uploadDocumentV1(baseUrl, params) {
+    const url = `${base(baseUrl)}/v1/documents/${encodeURIComponent(params.documentId)}/upload`;
+    return (0, http_1.postAuthenticatedBinary)(url, {
+        accessToken: params.accessToken,
+        orgId: params.orgId,
+    }, params.body);
+}
+async function deleteDocumentV1(baseUrl, params) {
+    const url = `${base(baseUrl)}/v1/documents/${encodeURIComponent(params.documentId)}`;
+    return (0, http_1.deleteAuthenticated)(url, {
+        accessToken: params.accessToken,
+        orgId: params.orgId,
+    });
+}

package/dist/http.d.ts

@@ -13,3 +13,26 @@ export interface AuthenticatedGetOptions {
  * Throws on non-OK response with status and body attached.
  */
 export declare function getAuthenticated<T>(url: string, options: AuthenticatedGetOptions): Promise<T>;
+export interface AuthenticatedPostOptions {
+    accessToken: string;
+    orgId?: string;
+}
+/**
+ * Performs an authenticated POST with optional JSON body and returns parsed JSON.
+ * Throws on non-OK response with status and body attached.
+ */
+export declare function postAuthenticated<T>(url: string, options: AuthenticatedPostOptions, body?: Record<string, unknown>): Promise<T>;
+export interface AuthenticatedDeleteOptions {
+    accessToken: string;
+    orgId?: string;
+}
+/**
+ * Performs an authenticated DELETE. Expects 204 No Content on success.
+ * Throws on non-OK response with status and body attached.
+ */
+export declare function deleteAuthenticated(url: string, options: AuthenticatedDeleteOptions): Promise<void>;
+/**
+ * Performs an authenticated POST with binary body (e.g. application/octet-stream) and returns parsed JSON.
+ * Throws on non-OK response with status and body attached.
+ */
+export declare function postAuthenticatedBinary<T>(url: string, options: AuthenticatedPostOptions, body: ArrayBuffer | Uint8Array): Promise<T>;

package/dist/http.js

@@ -5,6 +5,9 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAuthenticated = getAuthenticated;
+exports.postAuthenticated = postAuthenticated;
+exports.deleteAuthenticated = deleteAuthenticated;
+exports.postAuthenticatedBinary = postAuthenticatedBinary;
 /**
  * Performs an authenticated GET and returns parsed JSON.
  * Throws on non-OK response with status and body attached.
@@ -27,3 +30,78 @@ async function getAuthenticated(url, options) {
     }
     return (await res.json());
 }
+/**
+ * Performs an authenticated POST with optional JSON body and returns parsed JSON.
+ * Throws on non-OK response with status and body attached.
+ */
+async function postAuthenticated(url, options, body) {
+    const headers = {
+        Authorization: `Bearer ${options.accessToken}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+    if (options.orgId != null) {
+        headers["X-Inklok-Org-Id"] = options.orgId;
+    }
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: body != null ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        const err = new Error(`API error ${res.status}: ${text}`);
+        err.status = res.status;
+        err.body = text;
+        throw err;
+    }
+    return (await res.json());
+}
+/**
+ * Performs an authenticated DELETE. Expects 204 No Content on success.
+ * Throws on non-OK response with status and body attached.
+ */
+async function deleteAuthenticated(url, options) {
+    const headers = {
+        Authorization: `Bearer ${options.accessToken}`,
+        Accept: "application/json",
+    };
+    if (options.orgId != null) {
+        headers["X-Inklok-Org-Id"] = options.orgId;
+    }
+    const res = await fetch(url, { method: "DELETE", headers });
+    if (!res.ok) {
+        const text = await res.text();
+        const err = new Error(`API error ${res.status}: ${text}`);
+        err.status = res.status;
+        err.body = text;
+        throw err;
+    }
+}
+/**
+ * Performs an authenticated POST with binary body (e.g. application/octet-stream) and returns parsed JSON.
+ * Throws on non-OK response with status and body attached.
+ */
+async function postAuthenticatedBinary(url, options, body) {
+    const headers = {
+        Authorization: `Bearer ${options.accessToken}`,
+        "Content-Type": "application/octet-stream",
+        Accept: "application/json",
+    };
+    if (options.orgId != null) {
+        headers["X-Inklok-Org-Id"] = options.orgId;
+    }
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        const err = new Error(`API error ${res.status}: ${text}`);
+        err.status = res.status;
+        err.body = text;
+        throw err;
+    }
+    return (await res.json());
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * inklok-sdk-node - Node.js SDK for Inklok/OpaqueInk public API
  */
-export { InklokClient, type ListMeOrgsParams, type ListMeOrgsResponse, type ListOrkMetadataV1Params, type ListOrkMetadataV1Response, type ListOrgMembersV1Params, type ListOrgMembersV1Response, type MeOrg, type OrkMetadata, type OrgMember, } from "./client";
+export { InklokClient, type CreateDocumentV1Params, type CreateDocumentV1Response, type DocumentMetadata, type GetDocumentV1Params, type GetDocumentV1Response, type ListDocumentsV1Params, type ListDocumentsV1Response, type ListMeOrgsParams, type ListMeOrgsResponse, type ListOrkMetadataV1Params, type ListOrkMetadataV1Response, type ListOrgMembersV1Params, type ListOrgMembersV1Response, type MeOrg, type OrkMetadata, type OrgMember, type UploadDocumentV1Params, type UploadDocumentV1Response, type DeleteDocumentV1Params, type DeleteDocumentV1Response, } from "./client";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inklok-sdk-node",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Node.js SDK for Inklok public API",
   "publishConfig": {
     "access": "public"
@@ -11,7 +11,8 @@
     "dist"
   ],
   "scripts": {
-    "codegen": "openapi-typescript node_modules/@ryan-m-erickson/api-spec/openapi.yaml -o src/types.d.ts",
+    "codegen": "node scripts/codegen.js",
+    "codegen:spec": "openapi-typescript node_modules/@ryan-m-erickson/api-spec/openapi.yaml -o src/types.d.ts",
     "prebuild": "npm run codegen",
     "build": "tsc",
     "prepublishOnly": "npm run build"