@geekmidas/constructs 10.0.0-alpha.124 → 10.0.0-alpha.126

package/dist/{index-Cd2w-DRL.d.cts → index-BtzMzhMA.d.cts}

@@ -1,6 +1,6 @@
 import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
-import { a as EventFor, c as Topic, n as ConstructType, o as TopicEvent } from "./Construct-CFW0zjdD.cjs";
-import { i as FunctionHandler, n as Function } from "./Function-B0uZhZnU.cjs";
+import { a as EventFor, c as Topic, n as ConstructType, o as TopicEvent } from "./Construct-127M7yrl.cjs";
+import { i as FunctionHandler, n as Function } from "./Function-BIEsY0Hm.cjs";
 import { c as ServicesOf, r as Consumable } from "./construct-interface-B1AfqRl4.cjs";
 import { Logger } from "@geekmidas/logger";
 import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
@@ -112,4 +112,4 @@ declare class FunctionBuilder<TInput extends ComposableStandardSchema, OutSchema
 }
 //#endregion
 export { BaseFunctionBuilder as n, FunctionBuilder as t };
-//# sourceMappingURL=index-Cd2w-DRL.d.cts.map
+//# sourceMappingURL=index-BtzMzhMA.d.cts.map

package/dist/{index-Cd2w-DRL.d.cts.map → index-BtzMzhMA.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-Cd2w-DRL.d.cts","names":[],"sources":["../src/functions/BaseFunctionBuilder.ts","../src/functions/FunctionBuilder.ts"],"mappings":";;;;;;;;;uBAsBsB,oBACrB,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA;EAoFmB,MAAI;YAlFb,cAAc;YACd,eAAe;YACf;EAEH,WAAW;;;;;;;;;EASX;EACA,SAAS;;;;;;;EAQT;;;;;;;;EASA;;EAGA,SAAS;YACN,kBAAkB,QAAQ,0BAA0B;YACpD,mBAAmB,QAAQ,sBAAsB;;YAEjD;SAEH,mBAAmB,aAAa,KAAK;SAM/B,8BACZ,UAAU,sCACT,eAAe,QAAQ,IAAI,QAAQ,8BAA8B;EAkCnE,YAAmB,OAAI;WAEd,SAAS,UAAU,WAAW,UAAU;WAExC,OAAO,UAAU,QAAQ,QAAQ;EAE1C,QAAQ;WAIC,OAAO,UAAU,kBAAkB,QAAQ;WAE3C,MAAM,UAAU,0BAA0B,QAAQ;;;;;;;YAQjD,UACT,OAAO,iBACP,OAAO,SAAS;EAcjB,QAAQ,UAAU,cAAc,sBAC/B,SAAS,QAAQ,OAAO,KACtB,oBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA;;;;;EAuBD,SAAS,GAAG,sBACX,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,oBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA;;;;cCzKW,gBACZ,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,0CAI/C,oBACT,QACA,WACA,WACA,SACA,eACA,0BACA,WACA;EAI4B,MAAI;YAFtB;EAEV,YAA4B,OAAI;EAIvB,QAAQ;EAIjB,WAAW;EAIX,OAAO,UAAU,kBAChB,QAAQ,IACN,gBACF,QACA,GACA,WACA,SACA,eACA,0BACA,WACA,sBACA;EAiBD,MAAM,UAAU,0BACf,QAAQ,IACN,gBACF,GACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;;;;;;;;EA4BD,gBAAgB,mBAAmB,cAClC,YAAY,IACV,gBACF,QACA,eACI,cAAc,WAAW,KAC7B,SACA,eACA,0BACA,WACA,sBACA;EA8BD,SAAS,UAAU,WAClB,UAAU,IACR,gBACF,QACA,eACI,cAAc,IAClB,SACA,eACA,0BACA,WACA,sBACA;EAoBD,OAAO,UAAU,QAChB,QAAQ,IACN,gBACF,QACA,WACA,WACA,GACA,eACA,0BACA,WACA,sBACA;;;;;;;EAuBD,MAAM,eAAe,iBACpB,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,gBACF,QACA,eACI,WAAW,oBACf,SACA,eACA,0BACA,WACA,sBACA;EAeQ,QAAQ,UAAU,cAAc,sBACxC,SAAS,QAAQ,OAAO,KACtB,gBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA,sBACA;;;;;EAwBD,QAAQ,UAAU,qCAAqC,gBACtD,QACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;EAmBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,gBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA,OACA;EAkCD,OACC,IAAI,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,gBAEC,SACF,QACA,WACA,SACA,WACA,eACA,0BACA,WACA,sBACA,cACA,gBACC,QACA,WACA,SACA,WACA,WACA,eACA"}
+{"version":3,"file":"index-BtzMzhMA.d.cts","names":[],"sources":["../src/functions/BaseFunctionBuilder.ts","../src/functions/FunctionBuilder.ts"],"mappings":";;;;;;;;;uBAsBsB,oBACrB,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA;EAoFmB,MAAI;YAlFb,cAAc;YACd,eAAe;YACf;EAEH,WAAW;;;;;;;;;EASX;EACA,SAAS;;;;;;;EAQT;;;;;;;;EASA;;EAGA,SAAS;YACN,kBAAkB,QAAQ,0BAA0B;YACpD,mBAAmB,QAAQ,sBAAsB;;YAEjD;SAEH,mBAAmB,aAAa,KAAK;SAM/B,8BACZ,UAAU,sCACT,eAAe,QAAQ,IAAI,QAAQ,8BAA8B;EAkCnE,YAAmB,OAAI;WAEd,SAAS,UAAU,WAAW,UAAU;WAExC,OAAO,UAAU,QAAQ,QAAQ;EAE1C,QAAQ;WAIC,OAAO,UAAU,kBAAkB,QAAQ;WAE3C,MAAM,UAAU,0BAA0B,QAAQ;;;;;;;YAQjD,UACT,OAAO,iBACP,OAAO,SAAS;EAcjB,QAAQ,UAAU,cAAc,sBAC/B,SAAS,QAAQ,OAAO,KACtB,oBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA;;;;;EAuBD,SAAS,GAAG,sBACX,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,oBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA;;;;cCzKW,gBACZ,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,0CAI/C,oBACT,QACA,WACA,WACA,SACA,eACA,0BACA,WACA;EAI4B,MAAI;YAFtB;EAEV,YAA4B,OAAI;EAIvB,QAAQ;EAIjB,WAAW;EAIX,OAAO,UAAU,kBAChB,QAAQ,IACN,gBACF,QACA,GACA,WACA,SACA,eACA,0BACA,WACA,sBACA;EAiBD,MAAM,UAAU,0BACf,QAAQ,IACN,gBACF,GACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;;;;;;;;EA4BD,gBAAgB,mBAAmB,cAClC,YAAY,IACV,gBACF,QACA,eACI,cAAc,WAAW,KAC7B,SACA,eACA,0BACA,WACA,sBACA;EA8BD,SAAS,UAAU,WAClB,UAAU,IACR,gBACF,QACA,eACI,cAAc,IAClB,SACA,eACA,0BACA,WACA,sBACA;EAoBD,OAAO,UAAU,QAChB,QAAQ,IACN,gBACF,QACA,WACA,WACA,GACA,eACA,0BACA,WACA,sBACA;;;;;;;EAuBD,MAAM,eAAe,iBACpB,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,gBACF,QACA,eACI,WAAW,oBACf,SACA,eACA,0BACA,WACA,sBACA;EAeQ,QAAQ,UAAU,cAAc,sBACxC,SAAS,QAAQ,OAAO,KACtB,gBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA,sBACA;;;;;EAwBD,QAAQ,UAAU,qCAAqC,gBACtD,QACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;EAmBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,gBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA,OACA;EAkCD,OACC,IAAI,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,gBAEC,SACF,QACA,WACA,SACA,WACA,eACA,0BACA,WACA,sBACA,cACA,gBACC,QACA,WACA,SACA,WACA,WACA,eACA"}

package/dist/{index-aBIcAiH5.d.mts → index-DuriFjYD.d.mts}

@@ -1,6 +1,6 @@
 import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.mjs";
-import { a as EventFor, c as Topic, n as ConstructType, o as TopicEvent } from "./Construct-B7AXn0xH.mjs";
-import { i as FunctionHandler, n as Function } from "./Function-B_9R7Zy1.mjs";
+import { a as EventFor, c as Topic, n as ConstructType, o as TopicEvent } from "./Construct-DySlwh8o.mjs";
+import { i as FunctionHandler, n as Function } from "./Function-DfMzTGS4.mjs";
 import { c as ServicesOf, r as Consumable } from "./construct-interface-ZvYQbivO.mjs";
 import { Service } from "@geekmidas/services";
 import { AuditStorage, AuditableAction } from "@geekmidas/audit";
@@ -112,4 +112,4 @@ declare class FunctionBuilder<TInput extends ComposableStandardSchema, OutSchema
 }
 //#endregion
 export { BaseFunctionBuilder as n, FunctionBuilder as t };
-//# sourceMappingURL=index-aBIcAiH5.d.mts.map
+//# sourceMappingURL=index-DuriFjYD.d.mts.map

package/dist/{index-aBIcAiH5.d.mts.map → index-DuriFjYD.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-aBIcAiH5.d.mts","names":[],"sources":["../src/functions/BaseFunctionBuilder.ts","../src/functions/FunctionBuilder.ts"],"mappings":";;;;;;;;;uBAsBsB,oBACrB,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA;EAoFmB,MAAI;YAlFb,cAAc;YACd,eAAe;YACf;EAEH,WAAW;;;;;;;;;EASX;EACA,SAAS;;;;;;;EAQT;;;;;;;;EASA;;EAGA,SAAS;YACN,kBAAkB,QAAQ,0BAA0B;YACpD,mBAAmB,QAAQ,sBAAsB;;YAEjD;SAEH,mBAAmB,aAAa,KAAK;SAM/B,8BACZ,UAAU,sCACT,eAAe,QAAQ,IAAI,QAAQ,8BAA8B;EAkCnE,YAAmB,OAAI;WAEd,SAAS,UAAU,WAAW,UAAU;WAExC,OAAO,UAAU,QAAQ,QAAQ;EAE1C,QAAQ;WAIC,OAAO,UAAU,kBAAkB,QAAQ;WAE3C,MAAM,UAAU,0BAA0B,QAAQ;;;;;;;YAQjD,UACT,OAAO,iBACP,OAAO,SAAS;EAcjB,QAAQ,UAAU,cAAc,sBAC/B,SAAS,QAAQ,OAAO,KACtB,oBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA;;;;;EAuBD,SAAS,GAAG,sBACX,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,oBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA;;;;cCzKW,gBACZ,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,0CAI/C,oBACT,QACA,WACA,WACA,SACA,eACA,0BACA,WACA;EAI4B,MAAI;YAFtB;EAEV,YAA4B,OAAI;EAIvB,QAAQ;EAIjB,WAAW;EAIX,OAAO,UAAU,kBAChB,QAAQ,IACN,gBACF,QACA,GACA,WACA,SACA,eACA,0BACA,WACA,sBACA;EAiBD,MAAM,UAAU,0BACf,QAAQ,IACN,gBACF,GACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;;;;;;;;EA4BD,gBAAgB,mBAAmB,cAClC,YAAY,IACV,gBACF,QACA,eACI,cAAc,WAAW,KAC7B,SACA,eACA,0BACA,WACA,sBACA;EA8BD,SAAS,UAAU,WAClB,UAAU,IACR,gBACF,QACA,eACI,cAAc,IAClB,SACA,eACA,0BACA,WACA,sBACA;EAoBD,OAAO,UAAU,QAChB,QAAQ,IACN,gBACF,QACA,WACA,WACA,GACA,eACA,0BACA,WACA,sBACA;;;;;;;EAuBD,MAAM,eAAe,iBACpB,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,gBACF,QACA,eACI,WAAW,oBACf,SACA,eACA,0BACA,WACA,sBACA;EAeQ,QAAQ,UAAU,cAAc,sBACxC,SAAS,QAAQ,OAAO,KACtB,gBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA,sBACA;;;;;EAwBD,QAAQ,UAAU,qCAAqC,gBACtD,QACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;EAmBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,gBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA,OACA;EAkCD,OACC,IAAI,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,gBAEC,SACF,QACA,WACA,SACA,WACA,eACA,0BACA,WACA,sBACA,cACA,gBACC,QACA,WACA,SACA,WACA,WACA,eACA"}
+{"version":3,"file":"index-DuriFjYD.d.mts","names":[],"sources":["../src/functions/BaseFunctionBuilder.ts","../src/functions/FunctionBuilder.ts"],"mappings":";;;;;;;;;uBAsBsB,oBACrB,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA;EAoFmB,MAAI;YAlFb,cAAc;YACd,eAAe;YACf;EAEH,WAAW;;;;;;;;;EASX;EACA,SAAS;;;;;;;EAQT;;;;;;;;EASA;;EAGA,SAAS;YACN,kBAAkB,QAAQ,0BAA0B;YACpD,mBAAmB,QAAQ,sBAAsB;;YAEjD;SAEH,mBAAmB,aAAa,KAAK;SAM/B,8BACZ,UAAU,sCACT,eAAe,QAAQ,IAAI,QAAQ,8BAA8B;EAkCnE,YAAmB,OAAI;WAEd,SAAS,UAAU,WAAW,UAAU;WAExC,OAAO,UAAU,QAAQ,QAAQ;EAE1C,QAAQ;WAIC,OAAO,UAAU,kBAAkB,QAAQ;WAE3C,MAAM,UAAU,0BAA0B,QAAQ;;;;;;;YAQjD,UACT,OAAO,iBACP,OAAO,SAAS;EAcjB,QAAQ,UAAU,cAAc,sBAC/B,SAAS,QAAQ,OAAO,KACtB,oBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA;;;;;EAuBD,SAAS,GAAG,sBACX,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,oBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA;;;;cCzKW,gBACZ,eAAe,0BACf,kBAAkB,0CAClB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,0CAI/C,oBACT,QACA,WACA,WACA,SACA,eACA,0BACA,WACA;EAI4B,MAAI;YAFtB;EAEV,YAA4B,OAAI;EAIvB,QAAQ;EAIjB,WAAW;EAIX,OAAO,UAAU,kBAChB,QAAQ,IACN,gBACF,QACA,GACA,WACA,SACA,eACA,0BACA,WACA,sBACA;EAiBD,MAAM,UAAU,0BACf,QAAQ,IACN,gBACF,GACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;;;;;;;;EA4BD,gBAAgB,mBAAmB,cAClC,YAAY,IACV,gBACF,QACA,eACI,cAAc,WAAW,KAC7B,SACA,eACA,0BACA,WACA,sBACA;EA8BD,SAAS,UAAU,WAClB,UAAU,IACR,gBACF,QACA,eACI,cAAc,IAClB,SACA,eACA,0BACA,WACA,sBACA;EAoBD,OAAO,UAAU,QAChB,QAAQ,IACN,gBACF,QACA,WACA,WACA,GACA,eACA,0BACA,WACA,sBACA;;;;;;;EAuBD,MAAM,eAAe,iBACpB,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,gBACF,QACA,eACI,WAAW,oBACf,SACA,eACA,0BACA,WACA,sBACA;EAeQ,QAAQ,UAAU,cAAc,sBACxC,SAAS,QAAQ,OAAO,KACtB,gBACF,QACA,WACA,WACA,SACA,GACA,OACA,WACA,sBACA;;;;;EAwBD,QAAQ,UAAU,qCAAqC,gBACtD,QACA,WACA,WACA,SACA,eACA,0BACA,WACA,sBACA;;;;;EAmBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,gBACF,QACA,WACA,WACA,SACA,eACA,0BACA,GACA,OACA;EAkCD,OACC,IAAI,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,gBAEC,SACF,QACA,WACA,SACA,WACA,eACA,0BACA,WACA,sBACA,cACA,gBACC,QACA,WACA,SACA,WACA,WACA,eACA"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_Construct = require("./Construct-DEOVauyA.cjs");
+const require_Construct = require("./Construct-DorKS0Ua.cjs");
 const require_shutdown = require("./shutdown-BMJmAhSt.cjs");
 exports.Construct = require_Construct.Construct;
 exports.ConstructType = require_Construct.ConstructType;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-CFW0zjdD.cjs";
+import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-127M7yrl.cjs";
 import { n as LowerHttpMethod, r as RemoveUndefined, t as HttpMethod } from "./types-DMuSQeLL.cjs";
 import { i as TelemetryResponse, n as TelemetryContext, r as TelemetryRequest, t as Telemetry } from "./lambdaTelemetry-8vnmVZQ5.cjs";
 import { a as Stages, i as SeedContext, n as DeployedStage, o as TestStage, r as LocalStage, t as AnyStage } from "./stages-BSCF19o2.cjs";

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-B7AXn0xH.mjs";
+import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-DySlwh8o.mjs";
 import { n as LowerHttpMethod, r as RemoveUndefined, t as HttpMethod } from "./types-DMuSQeLL.mjs";
 import { i as TelemetryResponse, n as TelemetryContext, r as TelemetryRequest, t as Telemetry } from "./lambdaTelemetry-8vnmVZQ5.mjs";
 import { a as Stages, i as SeedContext, n as DeployedStage, o as TestStage, r as LocalStage, t as AnyStage } from "./stages-BSCF19o2.mjs";

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-CKUA-CTA.mjs";
+import { i as snifferContext, n as ConstructType, r as sniffService, t as Construct } from "./Construct-CGuc_Ijk.mjs";
 import { n as runShutdownHooks, t as onShutdown } from "./shutdown-C7xa8x9S.mjs";
 export { Construct, ConstructType, onShutdown, runShutdownHooks, sniffService, snifferContext };

package/dist/pattern-C1CEcglD.mjs

@@ -0,0 +1,241 @@
+import { t as Construct } from "./Construct-CGuc_Ijk.mjs";
+import { idsOf, servicesOf } from "./construct-interface.mjs";
+import { DERIVED_PREFIX as DERIVED_PREFIX$1 } from "@geekmidas/manifest";
+//#region src/processors/Processor.ts
+/**
+* A processor — a handler behind one path pattern of a file server, which
+* makes a derivative of an open object on read: a thumbnail, a page of a PDF.
+*
+* Built from the file server (`assets.process('/i/:width/*')`), so it carries
+* the bucket it reads and the open paths it may serve. Its parameters' schema
+* is the allowlist: a request outside it is refused before anything runs, so
+* nobody can mint new work — or new cache entries — by varying a number.
+*/
+var Processor = class extends Construct {
+	parsed;
+	handler;
+	options;
+	__IS_PROCESSOR__ = true;
+	static isProcessor(obj) {
+		return Boolean(obj && obj.__IS_PROCESSOR__ === true && obj.type === "dev.geekmidas.function.processor");
+	}
+	constructor(parsed, handler, options) {
+		super("dev.geekmidas.function.processor", options.logger, [options.origin, ...options.services], [], void 0, options.timeout, options.memorySize, void 0, [.../* @__PURE__ */ new Set([options.bucketId, ...options.constructs])]);
+		this.parsed = parsed;
+		this.handler = handler;
+		this.options = options;
+		this.owner = options.surfaceId;
+	}
+	/** The pattern it answers, as written. */
+	get pattern() {
+		return this.parsed.pattern;
+	}
+	/** The literal path the edge routes to it — `/i/`. */
+	get prefix() {
+		return this.parsed.prefix;
+	}
+	get native() {
+		return this.options.native;
+	}
+	get surfaceId() {
+		return this.options.surfaceId;
+	}
+	get bucketId() {
+		return this.options.bucketId;
+	}
+};
+//#endregion
+//#region src/processors/ProcessorBuilder.ts
+/** A native package named in a way no installer could resolve. */
+var ProcessorNativeInvalid = class extends Error {
+	packageName;
+	constructor(packageName) {
+		super(`'${packageName}' is not a package name. Name the package with native code as it is installed — 'sharp', '@napi-rs/canvas' — and its version is taken from the app's package.json.`);
+		this.packageName = packageName;
+		this.name = "ProcessorNativeInvalid";
+	}
+};
+/**
+* What `fileServer.process(pattern)` returns: a processor, built up one
+* immutable step at a time and finished by `.handle()`.
+*/
+var ProcessorBuilder = class ProcessorBuilder {
+	state;
+	constructor(state) {
+		this.state = state;
+	}
+	/**
+	* The parameters' schema — the allowlist. Every request is parsed by it
+	* before anything runs, and one it refuses is answered 400.
+	*/
+	params(schema) {
+		return new ProcessorBuilder({
+			...this.state,
+			paramsSchema: schema
+		});
+	}
+	/** Constructs its handler reaches, as `services.<id>`. */
+	dependsOn(constructs) {
+		const services = servicesOf(constructs);
+		return new ProcessorBuilder({
+			...this.state,
+			services: [...this.state.services.filter((service) => !services.some((s) => s.serviceName === service.serviceName)), ...services],
+			constructs: idsOf(constructs, this.state.constructs)
+		});
+	}
+	/**
+	* Packages with native code — `sharp` — installed for the target the
+	* processor runs on rather than bundled: linux in its image, arm64 on
+	* Lambda.
+	*/
+	native(packages) {
+		for (const name of packages) if (!/^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/.test(name)) throw new ProcessorNativeInvalid(name);
+		return new ProcessorBuilder({
+			...this.state,
+			native: [.../* @__PURE__ */ new Set([...this.state.native, ...packages])]
+		});
+	}
+	/** Milliseconds a request may take, where the target bounds it. */
+	timeout(ms) {
+		return new ProcessorBuilder({
+			...this.state,
+			timeout: ms
+		});
+	}
+	/** Megabytes of memory, where the target sets it. */
+	memorySize(mb) {
+		return new ProcessorBuilder({
+			...this.state,
+			memorySize: mb
+		});
+	}
+	handle(fn) {
+		const { state } = this;
+		return new Processor(state.parsed, fn, {
+			surfaceId: state.surfaceId,
+			bucketId: state.bucketId,
+			origin: state.origin,
+			serves: state.serves,
+			...state.paramsSchema ? { paramsSchema: state.paramsSchema } : {},
+			native: state.native,
+			logger: state.logger,
+			services: state.services,
+			constructs: state.constructs,
+			...state.timeout !== void 0 ? { timeout: state.timeout } : {},
+			...state.memorySize !== void 0 ? { memorySize: state.memorySize } : {}
+		});
+	}
+};
+//#endregion
+//#region src/processors/pattern.ts
+/** A pattern a processor cannot be served on. */
+var ProcessorPatternInvalid = class extends Error {
+	pattern;
+	reason;
+	constructor(pattern, reason) {
+		super(`'${pattern}' is not a processor pattern: ${reason}. A pattern is a literal first segment, then any \`:name\` parameters, then \`*\` for the object's key — '/i/:width/*'.`);
+		this.pattern = pattern;
+		this.reason = reason;
+		this.name = "ProcessorPatternInvalid";
+	}
+};
+/** @throws {ProcessorPatternInvalid} */
+function parsePattern(pattern) {
+	if (!pattern.startsWith("/")) throw new ProcessorPatternInvalid(pattern, "it does not start with /");
+	if (!pattern.endsWith("/*")) throw new ProcessorPatternInvalid(pattern, "it does not end with /* — the key");
+	const parts = pattern.slice(1, -2).split("/");
+	const segments = [];
+	const params = [];
+	for (const part of parts) {
+		if (part === "") throw new ProcessorPatternInvalid(pattern, "it has an empty segment");
+		if (part.includes("*")) throw new ProcessorPatternInvalid(pattern, "only its last segment may be *");
+		if (part.startsWith(":")) {
+			const name = part.slice(1);
+			if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) throw new ProcessorPatternInvalid(pattern, `'${part}' is not a parameter name`);
+			if (params.includes(name)) throw new ProcessorPatternInvalid(pattern, `'${name}' appears twice`);
+			params.push(name);
+			segments.push({
+				kind: "param",
+				name
+			});
+			continue;
+		}
+		if (!/^[A-Za-z0-9._~-]+$/.test(part)) throw new ProcessorPatternInvalid(pattern, `'${part}' has characters a path segment would escape`);
+		segments.push({
+			kind: "literal",
+			value: part
+		});
+	}
+	const first = segments[0];
+	if (!first || first.kind !== "literal") throw new ProcessorPatternInvalid(pattern, "its first segment is a parameter, which would claim every path");
+	const literals = [];
+	for (const segment of segments) {
+		if (segment.kind !== "literal") break;
+		literals.push(segment.value);
+	}
+	return {
+		pattern,
+		segments,
+		params,
+		prefix: `/${literals.join("/")}/`
+	};
+}
+/**
+* Match a request path, decoding each parameter and each key segment. A path
+* with an empty key, or one that decodes to a `..` segment, matches nothing.
+*/
+function matchPattern(parsed, path) {
+	const parts = path.replace(/^\/+/, "").split("/");
+	if (parts.length <= parsed.segments.length) return void 0;
+	const params = {};
+	for (const [index, segment] of parsed.segments.entries()) {
+		const part = decode(parts[index] ?? "");
+		if (part === void 0 || part === "") return void 0;
+		if (segment.kind === "literal") {
+			if (part !== segment.value) return void 0;
+			continue;
+		}
+		params[segment.name] = part;
+	}
+	const keyParts = parts.slice(parsed.segments.length).map(decode);
+	if (keyParts.some((part) => part === void 0 || part === "..")) return;
+	const key = keyParts.join("/");
+	if (key === "" || keyParts.includes("")) return void 0;
+	return {
+		params,
+		key
+	};
+}
+/** The path that addresses `key` through the pattern with these parameters. */
+function fillPattern(parsed, params, key) {
+	const head = parsed.segments.map((segment) => {
+		if (segment.kind === "literal") return segment.value;
+		const value = params[segment.name];
+		if (value === void 0 || `${value}` === "") throw new ProcessorParamMissing(parsed.pattern, segment.name);
+		return encodeURIComponent(`${value}`);
+	});
+	const tail = key.replace(/^\/+/, "").split("/").map((part) => encodeURIComponent(part));
+	return `/${[...head, ...tail].join("/")}`;
+}
+/** A processed URL was asked for without one of the pattern's parameters. */
+var ProcessorParamMissing = class extends Error {
+	pattern;
+	param;
+	constructor(pattern, param) {
+		super(`'${pattern}' needs '${param}' to address an object, and it was not given.`);
+		this.pattern = pattern;
+		this.param = param;
+		this.name = "ProcessorParamMissing";
+	}
+};
+function decode(part) {
+	try {
+		return decodeURIComponent(part);
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { parsePattern as a, DERIVED_PREFIX$1 as c, matchPattern as i, Processor as l, ProcessorPatternInvalid as n, ProcessorBuilder as o, fillPattern as r, ProcessorNativeInvalid as s, ProcessorParamMissing as t };
+
+//# sourceMappingURL=pattern-C1CEcglD.mjs.map

package/dist/pattern-C1CEcglD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-C1CEcglD.mjs","names":[],"sources":["../src/processors/Processor.ts","../src/processors/ProcessorBuilder.ts","../src/processors/pattern.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StorageClient } from '@geekmidas/storage';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\nimport type { ParsedPattern, PatternParams } from './pattern';\n\n/**\n * Where a processor's results are kept, under its file server's bucket.\n *\n * Written through on every result marked `immutable` and read before the\n * handler runs, so a derivative is made once. Exported so the bucket's expiry\n * can name it.\n */\nexport { DERIVED_PREFIX } from '@geekmidas/manifest';\n\n/** How long a response may be kept, by a browser and by the edge. */\nexport type ProcessorCache =\n\t/** Never changes for these parameters and this key: kept for a year. */\n\t| 'immutable'\n\t/** Kept this many seconds. */\n\t| { maxAge: number }\n\t/** Not kept. */\n\t| 'none';\n\n/** What a processor handler returns. */\nexport interface ProcessorResult {\n\tbody: Uint8Array | string;\n\tcontentType: string;\n\t/**\n\t * `immutable` results are also kept in the bucket, so the next request\n\t * for them never runs the handler. Defaults to an hour, kept nowhere.\n\t */\n\tcache?: ProcessorCache;\n}\n\n/** The object a request addresses, read from the bucket on first use. */\nexport interface SourceObject {\n\treadonly key: string;\n\tbytes(): Promise<Uint8Array>;\n\tstream(): Promise<ReadableStream<Uint8Array>>;\n\t/** The type it was stored with. */\n\tcontentType(): Promise<string | undefined>;\n}\n\nexport interface ProcessorContext<\n\tTParams,\n\tTServices extends Service[],\n\tTLogger extends Logger,\n> {\n\tparams: TParams;\n\tkey: string;\n\tobject: SourceObject;\n\tlogger: TLogger;\n\tservices: ServiceRecord<TServices>;\n}\n\nexport type ProcessorHandler<\n\tTParams,\n\tTServices extends Service[],\n\tTLogger extends Logger,\n> = (\n\tcontext: ProcessorContext<TParams, TServices, TLogger>,\n) => Promise<ProcessorResult> | ProcessorResult;\n\n/** What a processor's parameters parse to: its schema's output, or the raw strings. */\nexport type ProcessorParams<\n\tTPattern extends string,\n\tTSchema extends StandardSchemaV1 | undefined,\n> = TSchema extends StandardSchemaV1\n\t? InferStandardSchema<TSchema>\n\t: PatternParams<TPattern>;\n\n/**\n * A processor — a handler behind one path pattern of a file server, which\n * makes a derivative of an open object on read: a thumbnail, a page of a PDF.\n *\n * Built from the file server (`assets.process('/i/:width/*')`), so it carries\n * the bucket it reads and the open paths it may serve. Its parameters' schema\n * is the allowlist: a request outside it is refused before anything runs, so\n * nobody can mint new work — or new cache entries — by varying a number.\n */\nexport class Processor<\n\tTPattern extends string = string,\n\tTSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> extends Construct<TLogger, undefined, TServices> {\n\t__IS_PROCESSOR__ = true;\n\n\tstatic isProcessor(obj: unknown): obj is Processor<string, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_PROCESSOR__?: boolean }).__IS_PROCESSOR__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Processor,\n\t\t);\n\t}\n\n\tconstructor(\n\t\treadonly parsed: ParsedPattern,\n\t\treadonly handler: ProcessorHandler<\n\t\t\tProcessorParams<TPattern, TSchema>,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>,\n\t\treadonly options: {\n\t\t\t/** The file server's surface id — the unit that runs it. */\n\t\t\tsurfaceId: string;\n\t\t\t/** The bucket it reads from and keeps derivatives in. */\n\t\t\tbucketId: string;\n\t\t\t/** How it reaches that bucket. */\n\t\t\torigin: Service<string, StorageClient>;\n\t\t\t/** Whether a key is one of the file server's open paths. */\n\t\t\tserves: (key: string) => boolean;\n\t\t\tparamsSchema?: TSchema;\n\t\t\t/** Packages with native code, installed for the target. */\n\t\t\tnative: readonly string[];\n\t\t\tlogger: TLogger;\n\t\t\tservices: TServices;\n\t\t\tconstructs: string[];\n\t\t\ttimeout?: number;\n\t\t\tmemorySize?: number;\n\t\t},\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Processor,\n\t\t\toptions.logger,\n\t\t\t// The bucket is reached like any service — which is also how its URL\n\t\t\t// is found by the environment sniffer.\n\t\t\t[options.origin, ...options.services] as unknown as TServices,\n\t\t\t[],\n\t\t\tundefined,\n\t\t\toptions.timeout,\n\t\t\toptions.memorySize,\n\t\t\tundefined,\n\t\t\t// The bucket is an edge of its process, so the unit running it is\n\t\t\t// handed the bucket's address.\n\t\t\t[...new Set([options.bucketId, ...options.constructs])],\n\t\t);\n\t\tthis.owner = options.surfaceId;\n\t}\n\n\t/** The pattern it answers, as written. */\n\tget pattern(): TPattern {\n\t\treturn this.parsed.pattern as TPattern;\n\t}\n\n\t/** The literal path the edge routes to it — `/i/`. */\n\tget prefix(): string {\n\t\treturn this.parsed.prefix;\n\t}\n\n\tget native(): readonly string[] {\n\t\treturn this.options.native;\n\t}\n\n\tget surfaceId(): string {\n\t\treturn this.options.surfaceId;\n\t}\n\n\tget bucketId(): string {\n\t\treturn this.options.bucketId;\n\t}\n}\n","import type { Logger } from '@geekmidas/logger';\nimport type { Service } from '@geekmidas/services';\nimport type { StorageClient } from '@geekmidas/storage';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tservicesOf,\n} from '../construct-interface';\nimport {\n\tProcessor,\n\ttype ProcessorHandler,\n\ttype ProcessorParams,\n} from './Processor';\nimport type { ParsedPattern } from './pattern';\n\n/** A native package named in a way no installer could resolve. */\nexport class ProcessorNativeInvalid extends Error {\n\tconstructor(readonly packageName: string) {\n\t\tsuper(\n\t\t\t`'${packageName}' is not a package name. Name the package with native code ` +\n\t\t\t\t`as it is installed — 'sharp', '@napi-rs/canvas' — and its version ` +\n\t\t\t\t`is taken from the app's package.json.`,\n\t\t);\n\t\tthis.name = 'ProcessorNativeInvalid';\n\t}\n}\n\ninterface ProcessorBuilderState<TLogger extends Logger> {\n\tparsed: ParsedPattern;\n\tsurfaceId: string;\n\tbucketId: string;\n\torigin: Service<string, StorageClient>;\n\tserves: (key: string) => boolean;\n\tlogger: TLogger;\n\tparamsSchema?: StandardSchemaV1;\n\tnative: string[];\n\tservices: Service[];\n\tconstructs: string[];\n\ttimeout?: number;\n\tmemorySize?: number;\n}\n\n/**\n * What `fileServer.process(pattern)` returns: a processor, built up one\n * immutable step at a time and finished by `.handle()`.\n */\nexport class ProcessorBuilder<\n\tTPattern extends string,\n\tTSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tconstructor(private readonly state: ProcessorBuilderState<TLogger>) {}\n\n\t/**\n\t * The parameters' schema — the allowlist. Every request is parsed by it\n\t * before anything runs, and one it refuses is answered 400.\n\t */\n\tparams<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): ProcessorBuilder<TPattern, T, TServices, TLogger> {\n\t\treturn new ProcessorBuilder({ ...this.state, paramsSchema: schema });\n\t}\n\n\t/** Constructs its handler reaches, as `services.<id>`. */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): ProcessorBuilder<\n\t\tTPattern,\n\t\tTSchema,\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger\n\t> {\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\t\treturn new ProcessorBuilder({\n\t\t\t...this.state,\n\t\t\tservices: [\n\t\t\t\t...this.state.services.filter(\n\t\t\t\t\t(service) =>\n\t\t\t\t\t\t!services.some((s) => s.serviceName === service.serviceName),\n\t\t\t\t),\n\t\t\t\t...services,\n\t\t\t],\n\t\t\tconstructs: idsOf(constructs, this.state.constructs),\n\t\t});\n\t}\n\n\t/**\n\t * Packages with native code — `sharp` — installed for the target the\n\t * processor runs on rather than bundled: linux in its image, arm64 on\n\t * Lambda.\n\t */\n\tnative(packages: readonly string[]): this {\n\t\tfor (const name of packages) {\n\t\t\tif (!/^(@[a-z0-9._~-]+\\/)?[a-z0-9._~-]+$/.test(name)) {\n\t\t\t\tthrow new ProcessorNativeInvalid(name);\n\t\t\t}\n\t\t}\n\t\treturn new ProcessorBuilder({\n\t\t\t...this.state,\n\t\t\tnative: [...new Set([...this.state.native, ...packages])],\n\t\t}) as this;\n\t}\n\n\t/** Milliseconds a request may take, where the target bounds it. */\n\ttimeout(ms: number): this {\n\t\treturn new ProcessorBuilder({ ...this.state, timeout: ms }) as this;\n\t}\n\n\t/** Megabytes of memory, where the target sets it. */\n\tmemorySize(mb: number): this {\n\t\treturn new ProcessorBuilder({ ...this.state, memorySize: mb }) as this;\n\t}\n\n\thandle(\n\t\tfn: ProcessorHandler<\n\t\t\tProcessorParams<TPattern, TSchema>,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>,\n\t): Processor<TPattern, TSchema, TServices, TLogger> {\n\t\tconst { state } = this;\n\t\treturn new Processor<TPattern, TSchema, TServices, TLogger>(\n\t\t\tstate.parsed,\n\t\t\tfn,\n\t\t\t{\n\t\t\t\tsurfaceId: state.surfaceId,\n\t\t\t\tbucketId: state.bucketId,\n\t\t\t\torigin: state.origin,\n\t\t\t\tserves: state.serves,\n\t\t\t\t...(state.paramsSchema\n\t\t\t\t\t? { paramsSchema: state.paramsSchema as TSchema }\n\t\t\t\t\t: {}),\n\t\t\t\tnative: state.native,\n\t\t\t\tlogger: state.logger,\n\t\t\t\tservices: state.services as TServices,\n\t\t\t\tconstructs: state.constructs,\n\t\t\t\t...(state.timeout !== undefined ? { timeout: state.timeout } : {}),\n\t\t\t\t...(state.memorySize !== undefined\n\t\t\t\t\t? { memorySize: state.memorySize }\n\t\t\t\t\t: {}),\n\t\t\t},\n\t\t);\n\t}\n}\n","/**\n * A processor's path pattern: literal segments, `:name` parameters, and a\n * final `*` that is the object's key.\n *\n * ```\n * /i/:width/*        →  /i/256/avatars/7.png   { width: '256' }, 'avatars/7.png'\n * /pdf/:page/:dpi/*  →  /pdf/1/150/doc.pdf     { page: '1', dpi: '150' }, 'doc.pdf'\n * ```\n *\n * It starts with a literal segment because the edge routes on that prefix: a\n * pattern beginning with a parameter would claim every path on the file\n * server, objects included.\n */\n\n/** The parameter names a pattern declares, as a union. */\nexport type PatternParamNames<P extends string> =\n\tP extends `${string}/:${infer Name}/${infer Rest}`\n\t\t? Name | PatternParamNames<`/${Rest}`>\n\t\t: never;\n\n/** The raw parameters a pattern matches, before its schema parses them. */\nexport type PatternParams<P extends string> = {\n\t[K in PatternParamNames<P>]: string;\n};\n\n/** A pattern a processor cannot be served on. */\nexport class ProcessorPatternInvalid extends Error {\n\tconstructor(\n\t\treadonly pattern: string,\n\t\treadonly reason: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${pattern}' is not a processor pattern: ${reason}. A pattern is a ` +\n\t\t\t\t`literal first segment, then any \\`:name\\` parameters, then \\`*\\` ` +\n\t\t\t\t`for the object's key — '/i/:width/*'.`,\n\t\t);\n\t\tthis.name = 'ProcessorPatternInvalid';\n\t}\n}\n\n/** A pattern, parsed once. */\nexport interface ParsedPattern {\n\treadonly pattern: string;\n\t/** Each segment before the key: a literal, or a parameter's name. */\n\treadonly segments: readonly (\n\t\t| { kind: 'literal'; value: string }\n\t\t| { kind: 'param'; name: string }\n\t)[];\n\t/** The parameter names, in the order they appear. */\n\treadonly params: readonly string[];\n\t/** The literal path the edge routes on — `/i/`. */\n\treadonly prefix: string;\n}\n\n/** @throws {ProcessorPatternInvalid} */\nexport function parsePattern(pattern: string): ParsedPattern {\n\tif (!pattern.startsWith('/')) {\n\t\tthrow new ProcessorPatternInvalid(pattern, 'it does not start with /');\n\t}\n\tif (!pattern.endsWith('/*')) {\n\t\tthrow new ProcessorPatternInvalid(\n\t\t\tpattern,\n\t\t\t'it does not end with /* — the key',\n\t\t);\n\t}\n\n\tconst parts = pattern.slice(1, -2).split('/');\n\tconst segments: ParsedPattern['segments'][number][] = [];\n\tconst params: string[] = [];\n\tfor (const part of parts) {\n\t\tif (part === '') {\n\t\t\tthrow new ProcessorPatternInvalid(pattern, 'it has an empty segment');\n\t\t}\n\t\tif (part.includes('*')) {\n\t\t\tthrow new ProcessorPatternInvalid(\n\t\t\t\tpattern,\n\t\t\t\t'only its last segment may be *',\n\t\t\t);\n\t\t}\n\t\tif (part.startsWith(':')) {\n\t\t\tconst name = part.slice(1);\n\t\t\tif (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {\n\t\t\t\tthrow new ProcessorPatternInvalid(\n\t\t\t\t\tpattern,\n\t\t\t\t\t`'${part}' is not a parameter name`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (params.includes(name)) {\n\t\t\t\tthrow new ProcessorPatternInvalid(pattern, `'${name}' appears twice`);\n\t\t\t}\n\t\t\tparams.push(name);\n\t\t\tsegments.push({ kind: 'param', name });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!/^[A-Za-z0-9._~-]+$/.test(part)) {\n\t\t\tthrow new ProcessorPatternInvalid(\n\t\t\t\tpattern,\n\t\t\t\t`'${part}' has characters a path segment would escape`,\n\t\t\t);\n\t\t}\n\t\tsegments.push({ kind: 'literal', value: part });\n\t}\n\n\tconst first = segments[0];\n\tif (!first || first.kind !== 'literal') {\n\t\tthrow new ProcessorPatternInvalid(\n\t\t\tpattern,\n\t\t\t'its first segment is a parameter, which would claim every path',\n\t\t);\n\t}\n\n\tconst literals: string[] = [];\n\tfor (const segment of segments) {\n\t\tif (segment.kind !== 'literal') break;\n\t\tliterals.push(segment.value);\n\t}\n\n\treturn { pattern, segments, params, prefix: `/${literals.join('/')}/` };\n}\n\n/** A path the pattern matched: its raw parameters and the key. */\nexport interface PatternMatch {\n\tparams: Record<string, string>;\n\tkey: string;\n}\n\n/**\n * Match a request path, decoding each parameter and each key segment. A path\n * with an empty key, or one that decodes to a `..` segment, matches nothing.\n */\nexport function matchPattern(\n\tparsed: ParsedPattern,\n\tpath: string,\n): PatternMatch | undefined {\n\tconst parts = path.replace(/^\\/+/, '').split('/');\n\tif (parts.length <= parsed.segments.length) return undefined;\n\n\tconst params: Record<string, string> = {};\n\tfor (const [index, segment] of parsed.segments.entries()) {\n\t\tconst part = decode(parts[index] ?? '');\n\t\tif (part === undefined || part === '') return undefined;\n\t\tif (segment.kind === 'literal') {\n\t\t\tif (part !== segment.value) return undefined;\n\t\t\tcontinue;\n\t\t}\n\t\tparams[segment.name] = part;\n\t}\n\n\tconst keyParts = parts.slice(parsed.segments.length).map(decode);\n\tif (keyParts.some((part) => part === undefined || part === '..')) {\n\t\treturn undefined;\n\t}\n\tconst key = keyParts.join('/');\n\tif (key === '' || keyParts.includes('')) return undefined;\n\n\treturn { params, key };\n}\n\n/** The path that addresses `key` through the pattern with these parameters. */\nexport function fillPattern(\n\tparsed: ParsedPattern,\n\tparams: Readonly<Record<string, string | number>>,\n\tkey: string,\n): string {\n\tconst head = parsed.segments.map((segment) => {\n\t\tif (segment.kind === 'literal') return segment.value;\n\t\tconst value = params[segment.name];\n\t\tif (value === undefined || `${value}` === '') {\n\t\t\tthrow new ProcessorParamMissing(parsed.pattern, segment.name);\n\t\t}\n\t\treturn encodeURIComponent(`${value}`);\n\t});\n\tconst tail = key\n\t\t.replace(/^\\/+/, '')\n\t\t.split('/')\n\t\t.map((part) => encodeURIComponent(part));\n\n\treturn `/${[...head, ...tail].join('/')}`;\n}\n\n/** A processed URL was asked for without one of the pattern's parameters. */\nexport class ProcessorParamMissing extends Error {\n\tconstructor(\n\t\treadonly pattern: string,\n\t\treadonly param: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${pattern}' needs '${param}' to address an object, and it was not given.`,\n\t\t);\n\t\tthis.name = 'ProcessorParamMissing';\n\t}\n}\n\nfunction decode(part: string): string | undefined {\n\ttry {\n\t\treturn decodeURIComponent(part);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"],"mappings":"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"}

package/dist/pattern-QFaUIr77.cjs

@@ -0,0 +1,288 @@
+const require_Construct = require("./Construct-DorKS0Ua.cjs");
+const require_construct_interface = require("./construct-interface.cjs");
+require("@geekmidas/manifest");
+//#region src/processors/Processor.ts
+/**
+* A processor — a handler behind one path pattern of a file server, which
+* makes a derivative of an open object on read: a thumbnail, a page of a PDF.
+*
+* Built from the file server (`assets.process('/i/:width/*')`), so it carries
+* the bucket it reads and the open paths it may serve. Its parameters' schema
+* is the allowlist: a request outside it is refused before anything runs, so
+* nobody can mint new work — or new cache entries — by varying a number.
+*/
+var Processor = class extends require_Construct.Construct {
+	parsed;
+	handler;
+	options;
+	__IS_PROCESSOR__ = true;
+	static isProcessor(obj) {
+		return Boolean(obj && obj.__IS_PROCESSOR__ === true && obj.type === "dev.geekmidas.function.processor");
+	}
+	constructor(parsed, handler, options) {
+		super("dev.geekmidas.function.processor", options.logger, [options.origin, ...options.services], [], void 0, options.timeout, options.memorySize, void 0, [.../* @__PURE__ */ new Set([options.bucketId, ...options.constructs])]);
+		this.parsed = parsed;
+		this.handler = handler;
+		this.options = options;
+		this.owner = options.surfaceId;
+	}
+	/** The pattern it answers, as written. */
+	get pattern() {
+		return this.parsed.pattern;
+	}
+	/** The literal path the edge routes to it — `/i/`. */
+	get prefix() {
+		return this.parsed.prefix;
+	}
+	get native() {
+		return this.options.native;
+	}
+	get surfaceId() {
+		return this.options.surfaceId;
+	}
+	get bucketId() {
+		return this.options.bucketId;
+	}
+};
+//#endregion
+//#region src/processors/ProcessorBuilder.ts
+/** A native package named in a way no installer could resolve. */
+var ProcessorNativeInvalid = class extends Error {
+	packageName;
+	constructor(packageName) {
+		super(`'${packageName}' is not a package name. Name the package with native code as it is installed — 'sharp', '@napi-rs/canvas' — and its version is taken from the app's package.json.`);
+		this.packageName = packageName;
+		this.name = "ProcessorNativeInvalid";
+	}
+};
+/**
+* What `fileServer.process(pattern)` returns: a processor, built up one
+* immutable step at a time and finished by `.handle()`.
+*/
+var ProcessorBuilder = class ProcessorBuilder {
+	state;
+	constructor(state) {
+		this.state = state;
+	}
+	/**
+	* The parameters' schema — the allowlist. Every request is parsed by it
+	* before anything runs, and one it refuses is answered 400.
+	*/
+	params(schema) {
+		return new ProcessorBuilder({
+			...this.state,
+			paramsSchema: schema
+		});
+	}
+	/** Constructs its handler reaches, as `services.<id>`. */
+	dependsOn(constructs) {
+		const services = require_construct_interface.servicesOf(constructs);
+		return new ProcessorBuilder({
+			...this.state,
+			services: [...this.state.services.filter((service) => !services.some((s) => s.serviceName === service.serviceName)), ...services],
+			constructs: require_construct_interface.idsOf(constructs, this.state.constructs)
+		});
+	}
+	/**
+	* Packages with native code — `sharp` — installed for the target the
+	* processor runs on rather than bundled: linux in its image, arm64 on
+	* Lambda.
+	*/
+	native(packages) {
+		for (const name of packages) if (!/^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/.test(name)) throw new ProcessorNativeInvalid(name);
+		return new ProcessorBuilder({
+			...this.state,
+			native: [.../* @__PURE__ */ new Set([...this.state.native, ...packages])]
+		});
+	}
+	/** Milliseconds a request may take, where the target bounds it. */
+	timeout(ms) {
+		return new ProcessorBuilder({
+			...this.state,
+			timeout: ms
+		});
+	}
+	/** Megabytes of memory, where the target sets it. */
+	memorySize(mb) {
+		return new ProcessorBuilder({
+			...this.state,
+			memorySize: mb
+		});
+	}
+	handle(fn) {
+		const { state } = this;
+		return new Processor(state.parsed, fn, {
+			surfaceId: state.surfaceId,
+			bucketId: state.bucketId,
+			origin: state.origin,
+			serves: state.serves,
+			...state.paramsSchema ? { paramsSchema: state.paramsSchema } : {},
+			native: state.native,
+			logger: state.logger,
+			services: state.services,
+			constructs: state.constructs,
+			...state.timeout !== void 0 ? { timeout: state.timeout } : {},
+			...state.memorySize !== void 0 ? { memorySize: state.memorySize } : {}
+		});
+	}
+};
+//#endregion
+//#region src/processors/pattern.ts
+/** A pattern a processor cannot be served on. */
+var ProcessorPatternInvalid = class extends Error {
+	pattern;
+	reason;
+	constructor(pattern, reason) {
+		super(`'${pattern}' is not a processor pattern: ${reason}. A pattern is a literal first segment, then any \`:name\` parameters, then \`*\` for the object's key — '/i/:width/*'.`);
+		this.pattern = pattern;
+		this.reason = reason;
+		this.name = "ProcessorPatternInvalid";
+	}
+};
+/** @throws {ProcessorPatternInvalid} */
+function parsePattern(pattern) {
+	if (!pattern.startsWith("/")) throw new ProcessorPatternInvalid(pattern, "it does not start with /");
+	if (!pattern.endsWith("/*")) throw new ProcessorPatternInvalid(pattern, "it does not end with /* — the key");
+	const parts = pattern.slice(1, -2).split("/");
+	const segments = [];
+	const params = [];
+	for (const part of parts) {
+		if (part === "") throw new ProcessorPatternInvalid(pattern, "it has an empty segment");
+		if (part.includes("*")) throw new ProcessorPatternInvalid(pattern, "only its last segment may be *");
+		if (part.startsWith(":")) {
+			const name = part.slice(1);
+			if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) throw new ProcessorPatternInvalid(pattern, `'${part}' is not a parameter name`);
+			if (params.includes(name)) throw new ProcessorPatternInvalid(pattern, `'${name}' appears twice`);
+			params.push(name);
+			segments.push({
+				kind: "param",
+				name
+			});
+			continue;
+		}
+		if (!/^[A-Za-z0-9._~-]+$/.test(part)) throw new ProcessorPatternInvalid(pattern, `'${part}' has characters a path segment would escape`);
+		segments.push({
+			kind: "literal",
+			value: part
+		});
+	}
+	const first = segments[0];
+	if (!first || first.kind !== "literal") throw new ProcessorPatternInvalid(pattern, "its first segment is a parameter, which would claim every path");
+	const literals = [];
+	for (const segment of segments) {
+		if (segment.kind !== "literal") break;
+		literals.push(segment.value);
+	}
+	return {
+		pattern,
+		segments,
+		params,
+		prefix: `/${literals.join("/")}/`
+	};
+}
+/**
+* Match a request path, decoding each parameter and each key segment. A path
+* with an empty key, or one that decodes to a `..` segment, matches nothing.
+*/
+function matchPattern(parsed, path) {
+	const parts = path.replace(/^\/+/, "").split("/");
+	if (parts.length <= parsed.segments.length) return void 0;
+	const params = {};
+	for (const [index, segment] of parsed.segments.entries()) {
+		const part = decode(parts[index] ?? "");
+		if (part === void 0 || part === "") return void 0;
+		if (segment.kind === "literal") {
+			if (part !== segment.value) return void 0;
+			continue;
+		}
+		params[segment.name] = part;
+	}
+	const keyParts = parts.slice(parsed.segments.length).map(decode);
+	if (keyParts.some((part) => part === void 0 || part === "..")) return;
+	const key = keyParts.join("/");
+	if (key === "" || keyParts.includes("")) return void 0;
+	return {
+		params,
+		key
+	};
+}
+/** The path that addresses `key` through the pattern with these parameters. */
+function fillPattern(parsed, params, key) {
+	const head = parsed.segments.map((segment) => {
+		if (segment.kind === "literal") return segment.value;
+		const value = params[segment.name];
+		if (value === void 0 || `${value}` === "") throw new ProcessorParamMissing(parsed.pattern, segment.name);
+		return encodeURIComponent(`${value}`);
+	});
+	const tail = key.replace(/^\/+/, "").split("/").map((part) => encodeURIComponent(part));
+	return `/${[...head, ...tail].join("/")}`;
+}
+/** A processed URL was asked for without one of the pattern's parameters. */
+var ProcessorParamMissing = class extends Error {
+	pattern;
+	param;
+	constructor(pattern, param) {
+		super(`'${pattern}' needs '${param}' to address an object, and it was not given.`);
+		this.pattern = pattern;
+		this.param = param;
+		this.name = "ProcessorParamMissing";
+	}
+};
+function decode(part) {
+	try {
+		return decodeURIComponent(part);
+	} catch {
+		return;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "Processor", {
+	enumerable: true,
+	get: function() {
+		return Processor;
+	}
+});
+Object.defineProperty(exports, "ProcessorBuilder", {
+	enumerable: true,
+	get: function() {
+		return ProcessorBuilder;
+	}
+});
+Object.defineProperty(exports, "ProcessorNativeInvalid", {
+	enumerable: true,
+	get: function() {
+		return ProcessorNativeInvalid;
+	}
+});
+Object.defineProperty(exports, "ProcessorParamMissing", {
+	enumerable: true,
+	get: function() {
+		return ProcessorParamMissing;
+	}
+});
+Object.defineProperty(exports, "ProcessorPatternInvalid", {
+	enumerable: true,
+	get: function() {
+		return ProcessorPatternInvalid;
+	}
+});
+Object.defineProperty(exports, "fillPattern", {
+	enumerable: true,
+	get: function() {
+		return fillPattern;
+	}
+});
+Object.defineProperty(exports, "matchPattern", {
+	enumerable: true,
+	get: function() {
+		return matchPattern;
+	}
+});
+Object.defineProperty(exports, "parsePattern", {
+	enumerable: true,
+	get: function() {
+		return parsePattern;
+	}
+});
+
+//# sourceMappingURL=pattern-QFaUIr77.cjs.map