@ai-matrx/alchemy 0.16.0 → 0.17.5

package/dist/operate-zip.cjs

@@ -0,0 +1,2 @@
+"use strict";var __create=Object.create;var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toESM=(mod,isNodeMode,target)=>(target=mod!=null?__create(__getProtoOf(mod)):{},__copyProps(isNodeMode||!mod||!mod.__esModule?__defProp(target,"default",{value:mod,enumerable:!0}):target,mod)),__toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var operate_zip_exports={};__export(operate_zip_exports,{buildZip:()=>buildZip,readZip:()=>readZip});module.exports=__toCommonJS(operate_zip_exports);async function buildZip(entries,options={}){let{default:JSZip}=await import("jszip"),zip=new JSZip;for(let e of entries)zip.file(e.path,e.data,e.date?{date:e.date}:void 0);return zip.generateAsync({type:"blob",compression:options.compression??"STORE",...options.level?{compressionOptions:{level:options.level}}:{},...options.comment?{comment:options.comment}:{}})}async function readZip(input){let{default:JSZip}=await import("jszip"),zip=await JSZip.loadAsync(input),wrap=o=>({path:o.name,directory:o.dir,text:()=>o.async("string"),bytes:()=>o.async("uint8array")});return{files:Object.values(zip.files).map(wrap),get:path=>zip.file(path)?wrap(zip.file(path)):null}}
+//# sourceMappingURL=operate-zip.cjs.map

package/dist/operate-zip.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/operate-zip.ts","../src/operate/zip.ts"],"sourcesContent":["/** `@ai-matrx/alchemy/operate/zip` — the one zip door (files → archive Blob, archive → files). JSZip loads on first use. */\nexport { buildZip, readZip, type ZipArchive, type ZipBuildOptions, type ZipEntry, type ZipFile } from \"./operate/zip\";\n","/**\n * `@ai-matrx/alchemy/operate/zip` — THE zip door: files in → one archive Blob, an archive in → its files.\n * JSZip loads on first use (`import()`), so a page that never zips never downloads it.\n */\n\nexport type ZipEntry = {\n  /** Path inside the archive; `a/b.txt` creates the folder. */\n  path: string;\n  data: string | Uint8Array | ArrayBuffer | Blob;\n  /** A fixed modification time keeps the bytes reproducible. */\n  date?: Date;\n};\nexport type ZipBuildOptions = {\n  compression?: \"STORE\" | \"DEFLATE\";\n  /** 1 (fast) – 9 (small); DEFLATE only. */\n  level?: number;\n  comment?: string;\n};\n\n/** Pack entries into a zip Blob. */\nexport async function buildZip(entries: readonly ZipEntry[], options: ZipBuildOptions = {}): Promise<Blob> {\n  const { default: JSZip } = await import(\"jszip\");\n  const zip = new JSZip();\n  for (const e of entries) zip.file(e.path, e.data, e.date ? { date: e.date } : undefined);\n  return zip.generateAsync({\n    type: \"blob\",\n    compression: options.compression ?? \"STORE\",\n    ...(options.level ? { compressionOptions: { level: options.level } } : {}),\n    ...(options.comment ? { comment: options.comment } : {}),\n  });\n}\n\nexport type ZipFile = {\n  path: string;\n  directory: boolean;\n  text(): Promise<string>;\n  bytes(): Promise<Uint8Array>;\n};\nexport type ZipArchive = {\n  /** Every entry (folders included), in archive order. */\n  files: ZipFile[];\n  /** One entry by exact path, or null. */\n  get(path: string): ZipFile | null;\n};\n\n/** Open an archive from bytes or a Blob/File. Throws when the bytes are not a zip. */\nexport async function readZip(input: Uint8Array | ArrayBuffer | Blob): Promise<ZipArchive> {\n  const { default: JSZip } = await import(\"jszip\");\n  const zip = await JSZip.loadAsync(input);\n  const wrap = (o: import(\"jszip\").JSZipObject): ZipFile => ({\n    path: o.name,\n    directory: o.dir,\n    text: () => o.async(\"string\"),\n    bytes: () => o.async(\"uint8array\"),\n  });\n  const files = Object.values(zip.files).map(wrap);\n  return { files, get: (path) => (zip.file(path) ? wrap(zip.file(path)!) : null) };\n}\n"],"mappings":"y5BAAA,sJCoBA,eAAsB,SAAS,QAA8B,QAA2B,CAAC,EAAkB,CACzG,GAAM,CAAE,QAAS,KAAM,EAAI,KAAM,QAAO,OAAO,EACzC,IAAM,IAAI,MAChB,QAAW,KAAK,QAAS,IAAI,KAAK,EAAE,KAAM,EAAE,KAAM,EAAE,KAAO,CAAE,KAAM,EAAE,IAAK,EAAI,MAAS,EACvF,OAAO,IAAI,cAAc,CACvB,KAAM,OACN,YAAa,QAAQ,aAAe,QACpC,GAAI,QAAQ,MAAQ,CAAE,mBAAoB,CAAE,MAAO,QAAQ,KAAM,CAAE,EAAI,CAAC,EACxE,GAAI,QAAQ,QAAU,CAAE,QAAS,QAAQ,OAAQ,EAAI,CAAC,CACxD,CAAC,CACH,CAgBA,eAAsB,QAAQ,MAA6D,CACzF,GAAM,CAAE,QAAS,KAAM,EAAI,KAAM,QAAO,OAAO,EACzC,IAAM,MAAM,MAAM,UAAU,KAAK,EACjC,KAAQ,IAA6C,CACzD,KAAM,EAAE,KACR,UAAW,EAAE,IACb,KAAM,IAAM,EAAE,MAAM,QAAQ,EAC5B,MAAO,IAAM,EAAE,MAAM,YAAY,CACnC,GAEA,MAAO,CAAE,MADK,OAAO,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,EAC/B,IAAM,MAAU,IAAI,KAAK,IAAI,EAAI,KAAK,IAAI,KAAK,IAAI,CAAE,EAAI,IAAM,CACjF","names":[]}

package/dist/operate-zip.d.cts

@@ -0,0 +1,35 @@
+/**
+ * `@ai-matrx/alchemy/operate/zip` — THE zip door: files in → one archive Blob, an archive in → its files.
+ * JSZip loads on first use (`import()`), so a page that never zips never downloads it.
+ */
+type ZipEntry = {
+    /** Path inside the archive; `a/b.txt` creates the folder. */
+    path: string;
+    data: string | Uint8Array | ArrayBuffer | Blob;
+    /** A fixed modification time keeps the bytes reproducible. */
+    date?: Date;
+};
+type ZipBuildOptions = {
+    compression?: "STORE" | "DEFLATE";
+    /** 1 (fast) – 9 (small); DEFLATE only. */
+    level?: number;
+    comment?: string;
+};
+/** Pack entries into a zip Blob. */
+declare function buildZip(entries: readonly ZipEntry[], options?: ZipBuildOptions): Promise<Blob>;
+type ZipFile = {
+    path: string;
+    directory: boolean;
+    text(): Promise<string>;
+    bytes(): Promise<Uint8Array>;
+};
+type ZipArchive = {
+    /** Every entry (folders included), in archive order. */
+    files: ZipFile[];
+    /** One entry by exact path, or null. */
+    get(path: string): ZipFile | null;
+};
+/** Open an archive from bytes or a Blob/File. Throws when the bytes are not a zip. */
+declare function readZip(input: Uint8Array | ArrayBuffer | Blob): Promise<ZipArchive>;
+
+export { type ZipArchive, type ZipBuildOptions, type ZipEntry, type ZipFile, buildZip, readZip };

package/dist/operate-zip.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `@ai-matrx/alchemy/operate/zip` — THE zip door: files in → one archive Blob, an archive in → its files.
+ * JSZip loads on first use (`import()`), so a page that never zips never downloads it.
+ */
+type ZipEntry = {
+    /** Path inside the archive; `a/b.txt` creates the folder. */
+    path: string;
+    data: string | Uint8Array | ArrayBuffer | Blob;
+    /** A fixed modification time keeps the bytes reproducible. */
+    date?: Date;
+};
+type ZipBuildOptions = {
+    compression?: "STORE" | "DEFLATE";
+    /** 1 (fast) – 9 (small); DEFLATE only. */
+    level?: number;
+    comment?: string;
+};
+/** Pack entries into a zip Blob. */
+declare function buildZip(entries: readonly ZipEntry[], options?: ZipBuildOptions): Promise<Blob>;
+type ZipFile = {
+    path: string;
+    directory: boolean;
+    text(): Promise<string>;
+    bytes(): Promise<Uint8Array>;
+};
+type ZipArchive = {
+    /** Every entry (folders included), in archive order. */
+    files: ZipFile[];
+    /** One entry by exact path, or null. */
+    get(path: string): ZipFile | null;
+};
+/** Open an archive from bytes or a Blob/File. Throws when the bytes are not a zip. */
+declare function readZip(input: Uint8Array | ArrayBuffer | Blob): Promise<ZipArchive>;
+
+export { type ZipArchive, type ZipBuildOptions, type ZipEntry, type ZipFile, buildZip, readZip };

package/dist/operate-zip.js

@@ -0,0 +1,2 @@
+async function buildZip(entries,options={}){let{default:JSZip}=await import("jszip"),zip=new JSZip;for(let e of entries)zip.file(e.path,e.data,e.date?{date:e.date}:void 0);return zip.generateAsync({type:"blob",compression:options.compression??"STORE",...options.level?{compressionOptions:{level:options.level}}:{},...options.comment?{comment:options.comment}:{}})}async function readZip(input){let{default:JSZip}=await import("jszip"),zip=await JSZip.loadAsync(input),wrap=o=>({path:o.name,directory:o.dir,text:()=>o.async("string"),bytes:()=>o.async("uint8array")});return{files:Object.values(zip.files).map(wrap),get:path=>zip.file(path)?wrap(zip.file(path)):null}}export{buildZip,readZip};
+//# sourceMappingURL=operate-zip.js.map

package/dist/operate-zip.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/operate/zip.ts"],"sourcesContent":["/**\n * `@ai-matrx/alchemy/operate/zip` — THE zip door: files in → one archive Blob, an archive in → its files.\n * JSZip loads on first use (`import()`), so a page that never zips never downloads it.\n */\n\nexport type ZipEntry = {\n  /** Path inside the archive; `a/b.txt` creates the folder. */\n  path: string;\n  data: string | Uint8Array | ArrayBuffer | Blob;\n  /** A fixed modification time keeps the bytes reproducible. */\n  date?: Date;\n};\nexport type ZipBuildOptions = {\n  compression?: \"STORE\" | \"DEFLATE\";\n  /** 1 (fast) – 9 (small); DEFLATE only. */\n  level?: number;\n  comment?: string;\n};\n\n/** Pack entries into a zip Blob. */\nexport async function buildZip(entries: readonly ZipEntry[], options: ZipBuildOptions = {}): Promise<Blob> {\n  const { default: JSZip } = await import(\"jszip\");\n  const zip = new JSZip();\n  for (const e of entries) zip.file(e.path, e.data, e.date ? { date: e.date } : undefined);\n  return zip.generateAsync({\n    type: \"blob\",\n    compression: options.compression ?? \"STORE\",\n    ...(options.level ? { compressionOptions: { level: options.level } } : {}),\n    ...(options.comment ? { comment: options.comment } : {}),\n  });\n}\n\nexport type ZipFile = {\n  path: string;\n  directory: boolean;\n  text(): Promise<string>;\n  bytes(): Promise<Uint8Array>;\n};\nexport type ZipArchive = {\n  /** Every entry (folders included), in archive order. */\n  files: ZipFile[];\n  /** One entry by exact path, or null. */\n  get(path: string): ZipFile | null;\n};\n\n/** Open an archive from bytes or a Blob/File. Throws when the bytes are not a zip. */\nexport async function readZip(input: Uint8Array | ArrayBuffer | Blob): Promise<ZipArchive> {\n  const { default: JSZip } = await import(\"jszip\");\n  const zip = await JSZip.loadAsync(input);\n  const wrap = (o: import(\"jszip\").JSZipObject): ZipFile => ({\n    path: o.name,\n    directory: o.dir,\n    text: () => o.async(\"string\"),\n    bytes: () => o.async(\"uint8array\"),\n  });\n  const files = Object.values(zip.files).map(wrap);\n  return { files, get: (path) => (zip.file(path) ? wrap(zip.file(path)!) : null) };\n}\n"],"mappings":"AAoBA,eAAsB,SAAS,QAA8B,QAA2B,CAAC,EAAkB,CACzG,GAAM,CAAE,QAAS,KAAM,EAAI,KAAM,QAAO,OAAO,EACzC,IAAM,IAAI,MAChB,QAAW,KAAK,QAAS,IAAI,KAAK,EAAE,KAAM,EAAE,KAAM,EAAE,KAAO,CAAE,KAAM,EAAE,IAAK,EAAI,MAAS,EACvF,OAAO,IAAI,cAAc,CACvB,KAAM,OACN,YAAa,QAAQ,aAAe,QACpC,GAAI,QAAQ,MAAQ,CAAE,mBAAoB,CAAE,MAAO,QAAQ,KAAM,CAAE,EAAI,CAAC,EACxE,GAAI,QAAQ,QAAU,CAAE,QAAS,QAAQ,OAAQ,EAAI,CAAC,CACxD,CAAC,CACH,CAgBA,eAAsB,QAAQ,MAA6D,CACzF,GAAM,CAAE,QAAS,KAAM,EAAI,KAAM,QAAO,OAAO,EACzC,IAAM,MAAM,MAAM,UAAU,KAAK,EACjC,KAAQ,IAA6C,CACzD,KAAM,EAAE,KACR,UAAW,EAAE,IACb,KAAM,IAAM,EAAE,MAAM,QAAQ,EAC5B,MAAO,IAAM,EAAE,MAAM,YAAY,CACnC,GAEA,MAAO,CAAE,MADK,OAAO,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,EAC/B,IAAM,MAAU,IAAI,KAAK,IAAI,EAAI,KAAK,IAAI,KAAK,IAAI,CAAE,EAAI,IAAM,CACjF","names":[]}