nap-sdk 0.2.2 → 0.2.4

package/dist/index.d.ts

@@ -2,4 +2,16 @@ export declare function parseUri(uri: string): Record<string, unknown>;
 export declare function parseManifest(yamlStr: string): Record<string, unknown>;
 export declare function resolve(uri: string, repoPath?: string): Record<string, unknown>;
 export declare function version(): string;
+/**
+ * Ingest raw media bytes into the content-addressed storage engine.
+ *
+ * The storage backend is determined by the ``NAP_STORAGE_BACKEND``
+ * environment variable at the Rust layer (``local`` or ``s3``).
+ *
+ * @param data - Raw bytes of the media asset (image, audio, mesh, etc.).
+ * @param 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>;
 //# 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":"AAIA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK/E;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK/E;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E"}

package/dist/index.js

@@ -16,3 +16,17 @@ export function resolve(uri, repoPath) {
 export function version() {
     return native.version();
 }
+/**
+ * Ingest raw media bytes into the content-addressed storage engine.
+ *
+ * The storage backend is determined by the ``NAP_STORAGE_BACKEND``
+ * environment variable at the Rust layer (``local`` or ``s3``).
+ *
+ * @param data - Raw bytes of the media asset (image, audio, mesh, etc.).
+ * @param 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 async function ingestMedia(data, format) {
+    return native.ingestMedia(data, format);
+}

package/dist/native.d.ts

@@ -3,6 +3,7 @@ interface NativeBindings {
     parseManifest(yamlStr: string): string;
     resolve(uri: string, repoPath: string): string;
     version(): string;
+    ingestMedia(data: Buffer, format: string): Promise<string>;
 }
 declare const native: NativeBindings;
 export default native;

package/dist/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,OAAO,IAAI,MAAM,CAAC;CACnB;AAGD,QAAA,MAAM,MAAM,EAA8B,cAAc,CAAC;AAEzD,eAAe,MAAM,CAAC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,OAAO,IAAI,MAAM,CAAC;IAClB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAGD,QAAA,MAAM,MAAM,EAA8B,cAAc,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/index.d.ts

@@ -7,3 +7,30 @@ 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

@@ -1,6 +1,6 @@
 {
   "name": "nap-sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "TypeScript SDK for NAP (Narrative Addressing Protocol), powered by Rust and NAPI-RS.",
   "license": "MIT",
   "repository": {