@portalshq/nap-sdk 0.3.6

package/dist/native.d.ts

@@ -0,0 +1,68 @@
+interface NativeBindings {
+    parseUri(uri: string): string;
+    uriNew(universe: string, entityType: string, entityId: string, fragment?: string): string;
+    uriIdentity(uri: string): string;
+    uriManifestPath(uri: string): string;
+    uriFormat(universe: string, entityType: string, entityId: string, fragment?: string): string;
+    entityTypeParse(s: string): string;
+    entityTypeDirectoryName(entityType: string): string;
+    entityTypeList(): string;
+    parseManifest(yamlStr: string): string;
+    manifestNew(universe: string, entityType: string, entityId: string, name: string): string;
+    manifestToYaml(jsonStr: string): string;
+    manifestFromYaml(yamlStr: string): string;
+    manifestContentHash(jsonStr: string): string;
+    manifestSetProperty(jsonStr: string, key: string, value: string): string;
+    manifestAddReference(jsonStr: string, key: string, value: string): string;
+    manifestSetRepresentation(jsonStr: string, key: string, hash: string, format: string, uri?: string, tier?: string): string;
+    manifestBumpVersion(jsonStr: string): string;
+    contentHashFromBytes(data: Buffer): string;
+    contentHashFromString(s: string): string;
+    contentHashParse(s: string): string;
+    contentHashVerify(hash: string, data: Buffer): boolean;
+    contentHashHexDigest(hash: string): string;
+    changeSet(path: string, oldValue: string | undefined | null, newValue: string): string;
+    changeDelete(path: string, oldValue: string): string;
+    changeAppend(path: string, newValue: string): string;
+    commitNew(parent: string | undefined | null, author: string, message: string, manifestHash: string, changesJson: string): string;
+    commitVerifyId(jsonStr: string): boolean;
+    repoInit(basePath: string, universe: string): string;
+    repoOpen(basePath: string, universe: string): string;
+    repoCreateEntity(basePath: string, universe: string, entityType: string, entityId: string, name: string, author: string): string;
+    repoReadManifest(basePath: string, universe: string, entityType: string, entityId: string): string;
+    repoReadManifestAtRef(basePath: string, universe: string, entityType: string, entityId: string, reference: string): string;
+    repoWriteManifest(basePath: string, universe: string, manifestJson: string): string;
+    repoCommitManifest(basePath: string, universe: string, entityType: string, entityId: string, message: string, author: string, changesJson: string): string;
+    repoDeleteEntity(basePath: string, universe: string, entityType: string, entityId: string, author: string): string;
+    repoHistory(basePath: string, universe: string, entityType: string, entityId: string, limit: number): string;
+    repoListEntities(basePath: string, universe: string, entityType: string): string;
+    repoCreateBranch(basePath: string, universe: string, name: string): string;
+    repoSwitchBranch(basePath: string, universe: string, name: string): string;
+    repoListBranches(basePath: string, universe: string): string;
+    repoCreateTag(basePath: string, universe: string, name: string): string;
+    repoListTags(basePath: string, universe: string): string;
+    repoHeadHash(basePath: string, universe: string): string;
+    repoRevertCommit(basePath: string, universe: string, commitHash: string, author: string): string;
+    repoAddRemote(basePath: string, universe: string, name: string, url: string): string;
+    repoRemoveRemote(basePath: string, universe: string, name: string): string;
+    repoListRemotes(basePath: string, universe: string): string;
+    repoPush(basePath: string, universe: string, remote?: string, branch?: string): string;
+    repoPull(basePath: string, universe: string, remote?: string, branch?: string): string;
+    resolve(uri: string, repoPath: string): string;
+    resolveWithOptions(uri: string, repoPath: string, branch?: string, commit?: string, tag?: string, path?: string): string;
+    resolveQuery(uri: string, repoPath: string, path: string): string;
+    listUniverses(repoPath: string): string;
+    manifestSchema(): string;
+    commitSchema(): string;
+    validateManifest(jsonStr: string): string;
+    validateCommit(jsonStr: string): string;
+    mergeMerge(schemaJson: string, base: string, current: string, proposed: string): string;
+    mergeDiff(schemaJson: string, base: string, candidate: string): string;
+    storageConfig(): string;
+    ingestMedia(data: Buffer, format: string): Promise<string>;
+    loreClone(url: string, destPath: string): string;
+    version(): string;
+}
+declare const native: NativeBindings;
+export default native;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

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

package/dist/native.js

@@ -0,0 +1,4 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const native = require("../index.cjs");
+export default native;

package/index.d.ts

@@ -0,0 +1,36 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export declare function parseUri(uriStr: string): string
+export declare function parseManifest(yamlStr: string): string
+export declare function resolve(uriStr: string, repoBasePath: string): string
+export declare function version(): string
+/**
+ * Ingest raw media bytes into the content-addressed storage engine.
+ *
+ * This is an async function returning a JavaScript Promise.  The storage
+ * backend is determined at runtime by the ``NAP_STORAGE_BACKEND``
+ * environment variable.
+ *
+ * ## Memory Safety (NAPI Buffer Ownership)
+ *
+ * The incoming [`Buffer`] is **copied** to an owned `Vec<u8>` **before**
+ * crossing the await boundary.  Holding a raw pointer to a V8 `ArrayBuffer`
+ * across an await point is unsafe because Node's garbage collector may
+ * invalidate or relocate the backing store.  By cloning eagerly we avoid
+ * use-after-free and data races.
+ *
+ * # Arguments
+ *
+ * * `data` — Raw bytes of the media asset (image, audio, mesh, etc.),
+ *   passed as a Node.js `Buffer`.
+ * * `format` — File extension without a leading dot (e.g. `"png"`,
+ *   `"jpg"`, `"wav"`, `"glb"`).
+ *
+ * # Returns
+ *
+ * A Promise resolving to the content-addressed hash `sha256:<hex>`.
+ */
+export declare function ingestMedia(data: Buffer, format: string): Promise<string>

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@portalshq/nap-sdk",
+  "version": "0.3.6",
+  "description": "TypeScript SDK for NAP (Narrative Addressing Protocol), powered by Rust and NAPI-RS.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DigitalCreationsCo/nap"
+  },
+  "homepage": "https://github.com/DigitalCreationsCo/nap#readme",
+  "bugs": {
+    "url": "https://github.com/DigitalCreationsCo/nap/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "index.cjs",
+    "index.d.ts",
+    "*.node"
+  ],
+  "scripts": {
+    "build:native": "napi build --cargo-cwd . --platform --release && node -e \"require('fs').renameSync('index.js', 'index.cjs')\"",
+    "build:types": "tsc -p tsconfig.json",
+    "build": "npm run build:native && npm run build:types",
+    "test": "vitest run"
+  },
+  "napi": {
+    "name": "nap-sdk",
+    "binaryName": "nap-sdk",
+    "triples": {
+      "defaults": true
+    }
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}