@platforma-sdk/package-builder-lib 1.1.0

package/dist/core/schemas/sw-json.cjs

@@ -0,0 +1,111 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_defaults = require("../../defaults.cjs");
+const require_util = require("../util.cjs");
+const require_artifacts = require("./artifacts.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/core/schemas/sw-json.ts
+const remoteLocationSchema = zod_v4.z.object({
+	registry: zod_v4.z.string().describe("name of the registry to use for package download"),
+	package: zod_v4.z.string().describe("full package path in registry, e.g. 'common/jdk/21.0.2.13.1-{os}-{arch}.tgz")
+});
+const assetSchema = zod_v4.z.object({
+	...remoteLocationSchema.shape,
+	url: zod_v4.z.string().describe("asset download URL")
+});
+const dockerSchema = zod_v4.z.object({
+	tag: zod_v4.z.string().describe("full image tag to pull on backend side to execute this software"),
+	entrypoint: zod_v4.z.array(zod_v4.z.string()).describe("override image's entrypoint"),
+	cmd: zod_v4.z.array(zod_v4.z.string()).describe("command to be run in the container"),
+	pkg: zod_v4.z.string().default(require_defaults.DOCKER_PLACEHOLDER_PKG).describe("what to substitute in place of \"{pkg}\" variable in \"cmd\" (for artifacts with docker autogeneration)")
+});
+const runEnvironmentSchema = zod_v4.z.object({
+	type: zod_v4.z.enum(require_artifacts.runEnvironmentTypes),
+	...remoteLocationSchema.shape,
+	["r-version"]: zod_v4.z.string().optional(),
+	["python-version"]: zod_v4.z.string().optional(),
+	["java-version"]: zod_v4.z.string().optional(),
+	envVars: zod_v4.z.array(zod_v4.z.string().regex(/=/, "environment variable should be specified in format: <var-name>=<var-value>, i.e.: MY_ENV=value")).optional(),
+	binDir: zod_v4.z.string()
+});
+const runDependencyJavaSchema = runEnvironmentSchema.extend({
+	type: zod_v4.z.literal("java"),
+	name: zod_v4.z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const runDependencyPythonSchema = runEnvironmentSchema.extend({
+	type: zod_v4.z.literal("python"),
+	["python-version"]: zod_v4.z.string(),
+	name: zod_v4.z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const runDependencyRSchema = runEnvironmentSchema.extend({
+	type: zod_v4.z.literal("R"),
+	["r-version"]: zod_v4.z.string(),
+	name: zod_v4.z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const commonPackageSettingsSchema = zod_v4.z.object({
+	cmd: zod_v4.z.array(zod_v4.z.string()).min(1).describe("run given command, appended by args from workflow"),
+	envVars: zod_v4.z.array(zod_v4.z.string().regex(/=/, "full environment variable specification is required: <var-name>=<var-value>, e.g.: IS_CI=yes")).optional()
+});
+const binaryPackageSchema = zod_v4.z.object({
+	type: zod_v4.z.literal("binary"),
+	...commonPackageSettingsSchema.shape,
+	pkg: zod_v4.z.string().optional().describe("location of all package contents in Docker container (default: /app)")
+});
+const javaPackageSettingsSchema = zod_v4.z.object({
+	type: zod_v4.z.literal("java"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyJavaSchema
+});
+const pythonPackageSettingsSchema = zod_v4.z.object({
+	type: zod_v4.z.literal("python"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyPythonSchema,
+	toolset: zod_v4.z.string(),
+	dependencies: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.string()).describe("paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'")
+});
+const rPackageSettingsSchema = zod_v4.z.object({
+	type: zod_v4.z.literal("R"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyRSchema,
+	toolset: zod_v4.z.string(),
+	dependencies: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.string()).describe("paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'")
+});
+const condaPackageSchema = zod_v4.z.object({
+	type: zod_v4.z.literal("conda"),
+	...commonPackageSettingsSchema.shape,
+	["micromamba-version"]: zod_v4.z.string().describe("version of micromamba to be used to operate with conda environments"),
+	["conda-root-dir"]: zod_v4.z.string().default(require_defaults.CONDA_DATA_LOCATION).describe("root directory of conda environment inside package root"),
+	spec: zod_v4.z.string().describe("location of spec.yaml describing conda environment, relative to package root.")
+});
+const remoteSoftwareSchema = zod_v4.z.union([
+	remoteLocationSchema.extend(binaryPackageSchema.shape),
+	remoteLocationSchema.extend(javaPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(pythonPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(rPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(condaPackageSchema.shape)
+]);
+const localLocationSchema = zod_v4.z.object({
+	hash: zod_v4.z.string().describe("hash of software directory. Makes deduplication to work properly when you actively develop software"),
+	path: zod_v4.z.string().describe("absolute path to root directory of software on local host")
+});
+const localSoftwareSchema = zod_v4.z.discriminatedUnion("type", [
+	localLocationSchema.extend(binaryPackageSchema.shape),
+	localLocationSchema.extend(javaPackageSettingsSchema.shape),
+	localLocationSchema.extend(pythonPackageSettingsSchema.shape),
+	localLocationSchema.extend(rPackageSettingsSchema.shape),
+	localLocationSchema.extend(condaPackageSchema.shape)
+]);
+const swJsonSchema = zod_v4.z.object({
+	isDev: zod_v4.z.boolean().optional(),
+	asset: assetSchema.optional(),
+	binary: remoteSoftwareSchema.optional(),
+	docker: dockerSchema.optional(),
+	runEnv: runEnvironmentSchema.optional(),
+	local: localSoftwareSchema.optional()
+}).refine((data) => require_util.toInt(data.runEnv) + require_util.toInt(data.binary || data.docker) + require_util.toInt(data.asset) + require_util.toInt(data.local) == 1, {
+	message: "entrypoint cannot point to several packages at once: choose 'environment', 'binary', 'asset', 'conda' or 'local'",
+	path: ["environment | binary | asset | conda | local"]
+});
+//#endregion
+exports.swJsonSchema = swJsonSchema;
+
+//# sourceMappingURL=sw-json.cjs.map

package/dist/core/schemas/sw-json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw-json.cjs","names":["z"],"sources":["../../../src/core/schemas/sw-json.ts"],"sourcesContent":["import { z } from \"zod/v4\";\nimport * as defaults from \"../../defaults\";\nimport * as artifacts from \"./artifacts\";\nimport * as util from \"../util\";\n\nexport const remoteLocationSchema = z.object({\n  registry: z.string().describe(\"name of the registry to use for package download\"),\n  package: z\n    .string()\n    .describe(\"full package path in registry, e.g. 'common/jdk/21.0.2.13.1-{os}-{arch}.tgz\"),\n});\n\nexport const assetSchema = z.object({\n  ...remoteLocationSchema.shape,\n  url: z.string().describe(\"asset download URL\"),\n});\nexport type assetInfo = z.infer<typeof assetSchema>;\n\nexport const dockerSchema = z.object({\n  tag: z.string().describe(\"full image tag to pull on backend side to execute this software\"),\n  entrypoint: z.array(z.string()).describe(\"override image's entrypoint\"),\n  cmd: z.array(z.string()).describe(\"command to be run in the container\"),\n\n  pkg: z\n    .string()\n    .default(defaults.DOCKER_PLACEHOLDER_PKG)\n    .describe(\n      'what to substitute in place of \"{pkg}\" variable in \"cmd\" (for artifacts with docker autogeneration)',\n    ),\n});\nexport type dockerInfo = z.infer<typeof dockerSchema>;\n\nexport const runEnvironmentSchema = z.object({\n  type: z.enum(artifacts.runEnvironmentTypes),\n  ...remoteLocationSchema.shape,\n\n  [\"r-version\"]: z.string().optional(),\n  [\"python-version\"]: z.string().optional(),\n  [\"java-version\"]: z.string().optional(),\n\n  envVars: z\n    .array(\n      z\n        .string()\n        .regex(\n          /=/,\n          \"environment variable should be specified in format: <var-name>=<var-value>, i.e.: MY_ENV=value\",\n        ),\n    )\n    .optional(),\n\n  binDir: z.string(),\n});\nexport type runEnvInfo = z.infer<typeof runEnvironmentSchema>;\n\nexport const runDependencyJavaSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"java\"),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyJava = z.infer<typeof runDependencyJavaSchema>;\n\nexport const runDependencyPythonSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"python\"),\n  [\"python-version\"]: z.string(),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyPython = z.infer<typeof runDependencyPythonSchema>;\n\nexport const runDependencyRSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"R\"),\n  [\"r-version\"]: z.string(),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyR = z.infer<typeof runDependencyRSchema>;\n\nexport type runEnvDependency = runEnvDependencyJava | runEnvDependencyPython | runEnvDependencyR;\n\nexport const commonPackageSettingsSchema = z.object({\n  cmd: z.array(z.string()).min(1).describe(\"run given command, appended by args from workflow\"),\n\n  envVars: z\n    .array(\n      z\n        .string()\n        .regex(\n          /=/,\n          \"full environment variable specification is required: <var-name>=<var-value>, e.g.: IS_CI=yes\",\n        ),\n    )\n    .optional(),\n});\n\nexport const binaryPackageSchema = z.object({\n  type: z.literal(\"binary\"),\n  ...commonPackageSettingsSchema.shape,\n\n  pkg: z\n    .string()\n    .optional()\n    .describe(\"location of all package contents in Docker container (default: /app)\"),\n});\n\nexport const javaPackageSettingsSchema = z.object({\n  type: z.literal(\"java\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyJavaSchema,\n});\n\nexport const pythonPackageSettingsSchema = z.object({\n  type: z.literal(\"python\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyPythonSchema,\n\n  toolset: z.string(),\n  dependencies: z\n    .record(z.string(), z.string())\n    .describe(\n      \"paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'\",\n    ),\n});\n\nexport const rPackageSettingsSchema = z.object({\n  type: z.literal(\"R\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyRSchema,\n\n  toolset: z.string(),\n  dependencies: z\n    .record(z.string(), z.string())\n    .describe(\n      \"paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'\",\n    ),\n});\n\nexport const condaPackageSchema = z.object({\n  type: z.literal(\"conda\"),\n  ...commonPackageSettingsSchema.shape,\n\n  [\"micromamba-version\"]: z\n    .string()\n    .describe(\"version of micromamba to be used to operate with conda environments\"),\n  [\"conda-root-dir\"]: z\n    .string()\n    .default(defaults.CONDA_DATA_LOCATION)\n    .describe(\"root directory of conda environment inside package root\"),\n\n  spec: z\n    .string()\n    .describe(\"location of spec.yaml describing conda environment, relative to package root.\"),\n});\n\nexport const remoteSoftwareSchema = z.union([\n  remoteLocationSchema.extend(binaryPackageSchema.shape),\n  remoteLocationSchema.extend(javaPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(pythonPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(rPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(condaPackageSchema.shape),\n]);\nexport type remoteSoftwareType = z.infer<typeof remoteSoftwareSchema>;\n\nexport const localLocationSchema = z.object({\n  hash: z\n    .string()\n    .describe(\n      \"hash of software directory. Makes deduplication to work properly when you actively develop software\",\n    ),\n  path: z.string().describe(\"absolute path to root directory of software on local host\"),\n});\n\nexport const localSoftwareSchema = z.discriminatedUnion(\"type\", [\n  localLocationSchema.extend(binaryPackageSchema.shape),\n  localLocationSchema.extend(javaPackageSettingsSchema.shape),\n  localLocationSchema.extend(pythonPackageSettingsSchema.shape),\n  localLocationSchema.extend(rPackageSettingsSchema.shape),\n  localLocationSchema.extend(condaPackageSchema.shape),\n  // Docker can be used 'as usual' without any special 'local' section magic\n]);\nexport type localSoftwareType = z.infer<typeof localSoftwareSchema>;\n\n// Full .sw.json file schema\nexport const swJsonSchema = z\n  .object({\n    isDev: z.boolean().optional(),\n\n    asset: assetSchema.optional(),\n    binary: remoteSoftwareSchema.optional(),\n    docker: dockerSchema.optional(),\n    runEnv: runEnvironmentSchema.optional(),\n    local: localSoftwareSchema.optional(),\n  })\n  .refine(\n    (data) =>\n      util.toInt(data.runEnv) +\n        util.toInt(data.binary || data.docker) + // allow both docker and binary to be set in single entrypoint\n        util.toInt(data.asset) +\n        util.toInt(data.local) ==\n      1,\n    {\n      message:\n        \"entrypoint cannot point to several packages at once: choose 'environment', 'binary', 'asset', 'conda' or 'local'\",\n      path: [\"environment | binary | asset | conda | local\"],\n    },\n  );\n\nexport type swJsonType = z.infer<typeof swJsonSchema> & {\n  id: util.artifactID;\n};\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuBA,OAAAA,EAAE,OAAO;CAC3C,UAAUA,OAAAA,EAAE,QAAQ,CAAC,SAAS,mDAAmD;CACjF,SAASA,OAAAA,EACN,QAAQ,CACR,SAAS,8EAA8E;CAC3F,CAAC;AAEF,MAAa,cAAcA,OAAAA,EAAE,OAAO;CAClC,GAAG,qBAAqB;CACxB,KAAKA,OAAAA,EAAE,QAAQ,CAAC,SAAS,qBAAqB;CAC/C,CAAC;AAGF,MAAa,eAAeA,OAAAA,EAAE,OAAO;CACnC,KAAKA,OAAAA,EAAE,QAAQ,CAAC,SAAS,kEAAkE;CAC3F,YAAYA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,QAAQ,CAAC,CAAC,SAAS,8BAA8B;CACvE,KAAKA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,QAAQ,CAAC,CAAC,SAAS,qCAAqC;CAEvE,KAAKA,OAAAA,EACF,QAAQ,CACR,QAAA,iBAAA,uBAAwC,CACxC,SACC,0GACD;CACJ,CAAC;AAGF,MAAa,uBAAuBA,OAAAA,EAAE,OAAO;CAC3C,MAAMA,OAAAA,EAAE,KAAA,kBAAA,oBAAmC;CAC3C,GAAG,qBAAqB;EAEvB,cAAcA,OAAAA,EAAE,QAAQ,CAAC,UAAU;EACnC,mBAAmBA,OAAAA,EAAE,QAAQ,CAAC,UAAU;EACxC,iBAAiBA,OAAAA,EAAE,QAAQ,CAAC,UAAU;CAEvC,SAASA,OAAAA,EACN,MACCA,OAAAA,EACG,QAAQ,CACR,MACC,KACA,iGACD,CACJ,CACA,UAAU;CAEb,QAAQA,OAAAA,EAAE,QAAQ;CACnB,CAAC;AAGF,MAAa,0BAA0B,qBAAqB,OAAO;CACjE,MAAMA,OAAAA,EAAE,QAAQ,OAAO;CACvB,MAAMA,OAAAA,EACH,QAAQ,CACR,SAAS,0EAA0E;CACvF,CAAC;AAGF,MAAa,4BAA4B,qBAAqB,OAAO;CACnE,MAAMA,OAAAA,EAAE,QAAQ,SAAS;EACxB,mBAAmBA,OAAAA,EAAE,QAAQ;CAC9B,MAAMA,OAAAA,EACH,QAAQ,CACR,SAAS,0EAA0E;CACvF,CAAC;AAGF,MAAa,uBAAuB,qBAAqB,OAAO;CAC9D,MAAMA,OAAAA,EAAE,QAAQ,IAAI;EACnB,cAAcA,OAAAA,EAAE,QAAQ;CACzB,MAAMA,OAAAA,EACH,QAAQ,CACR,SAAS,0EAA0E;CACvF,CAAC;AAKF,MAAa,8BAA8BA,OAAAA,EAAE,OAAO;CAClD,KAAKA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,oDAAoD;CAE7F,SAASA,OAAAA,EACN,MACCA,OAAAA,EACG,QAAQ,CACR,MACC,KACA,+FACD,CACJ,CACA,UAAU;CACd,CAAC;AAEF,MAAa,sBAAsBA,OAAAA,EAAE,OAAO;CAC1C,MAAMA,OAAAA,EAAE,QAAQ,SAAS;CACzB,GAAG,4BAA4B;CAE/B,KAAKA,OAAAA,EACF,QAAQ,CACR,UAAU,CACV,SAAS,uEAAuE;CACpF,CAAC;AAEF,MAAa,4BAA4BA,OAAAA,EAAE,OAAO;CAChD,MAAMA,OAAAA,EAAE,QAAQ,OAAO;CAEvB,GAAG,4BAA4B;CAC/B,QAAQ;CACT,CAAC;AAEF,MAAa,8BAA8BA,OAAAA,EAAE,OAAO;CAClD,MAAMA,OAAAA,EAAE,QAAQ,SAAS;CAEzB,GAAG,4BAA4B;CAC/B,QAAQ;CAER,SAASA,OAAAA,EAAE,QAAQ;CACnB,cAAcA,OAAAA,EACX,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,QAAQ,CAAC,CAC9B,SACC,+FACD;CACJ,CAAC;AAEF,MAAa,yBAAyBA,OAAAA,EAAE,OAAO;CAC7C,MAAMA,OAAAA,EAAE,QAAQ,IAAI;CAEpB,GAAG,4BAA4B;CAC/B,QAAQ;CAER,SAASA,OAAAA,EAAE,QAAQ;CACnB,cAAcA,OAAAA,EACX,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,QAAQ,CAAC,CAC9B,SACC,+FACD;CACJ,CAAC;AAEF,MAAa,qBAAqBA,OAAAA,EAAE,OAAO;CACzC,MAAMA,OAAAA,EAAE,QAAQ,QAAQ;CACxB,GAAG,4BAA4B;EAE9B,uBAAuBA,OAAAA,EACrB,QAAQ,CACR,SAAS,sEAAsE;EACjF,mBAAmBA,OAAAA,EACjB,QAAQ,CACR,QAAA,iBAAA,oBAAqC,CACrC,SAAS,0DAA0D;CAEtE,MAAMA,OAAAA,EACH,QAAQ,CACR,SAAS,gFAAgF;CAC7F,CAAC;AAEF,MAAa,uBAAuBA,OAAAA,EAAE,MAAM;CAC1C,qBAAqB,OAAO,oBAAoB,MAAM;CACtD,qBAAqB,OAAO,0BAA0B,MAAM;CAC5D,qBAAqB,OAAO,4BAA4B,MAAM;CAC9D,qBAAqB,OAAO,uBAAuB,MAAM;CACzD,qBAAqB,OAAO,mBAAmB,MAAM;CACtD,CAAC;AAGF,MAAa,sBAAsBA,OAAAA,EAAE,OAAO;CAC1C,MAAMA,OAAAA,EACH,QAAQ,CACR,SACC,sGACD;CACH,MAAMA,OAAAA,EAAE,QAAQ,CAAC,SAAS,4DAA4D;CACvF,CAAC;AAEF,MAAa,sBAAsBA,OAAAA,EAAE,mBAAmB,QAAQ;CAC9D,oBAAoB,OAAO,oBAAoB,MAAM;CACrD,oBAAoB,OAAO,0BAA0B,MAAM;CAC3D,oBAAoB,OAAO,4BAA4B,MAAM;CAC7D,oBAAoB,OAAO,uBAAuB,MAAM;CACxD,oBAAoB,OAAO,mBAAmB,MAAM;CAErD,CAAC;AAIF,MAAa,eAAeA,OAAAA,EACzB,OAAO;CACN,OAAOA,OAAAA,EAAE,SAAS,CAAC,UAAU;CAE7B,OAAO,YAAY,UAAU;CAC7B,QAAQ,qBAAqB,UAAU;CACvC,QAAQ,aAAa,UAAU;CAC/B,QAAQ,qBAAqB,UAAU;CACvC,OAAO,oBAAoB,UAAU;CACtC,CAAC,CACD,QACE,SAAA,aAAA,MACY,KAAK,OAAO,GAAA,aAAA,MACV,KAAK,UAAU,KAAK,OAAO,GAAA,aAAA,MAC3B,KAAK,MAAM,GAAA,aAAA,MACX,KAAK,MAAM,IACxB,GACF;CACE,SACE;CACF,MAAM,CAAC,+CAA+C;CACvD,CACF"}

package/dist/core/schemas/sw-json.js

@@ -0,0 +1,110 @@
+import { CONDA_DATA_LOCATION, DOCKER_PLACEHOLDER_PKG } from "../../defaults.js";
+import { toInt } from "../util.js";
+import { runEnvironmentTypes } from "./artifacts.js";
+import { z } from "zod/v4";
+//#region src/core/schemas/sw-json.ts
+const remoteLocationSchema = z.object({
+	registry: z.string().describe("name of the registry to use for package download"),
+	package: z.string().describe("full package path in registry, e.g. 'common/jdk/21.0.2.13.1-{os}-{arch}.tgz")
+});
+const assetSchema = z.object({
+	...remoteLocationSchema.shape,
+	url: z.string().describe("asset download URL")
+});
+const dockerSchema = z.object({
+	tag: z.string().describe("full image tag to pull on backend side to execute this software"),
+	entrypoint: z.array(z.string()).describe("override image's entrypoint"),
+	cmd: z.array(z.string()).describe("command to be run in the container"),
+	pkg: z.string().default(DOCKER_PLACEHOLDER_PKG).describe("what to substitute in place of \"{pkg}\" variable in \"cmd\" (for artifacts with docker autogeneration)")
+});
+const runEnvironmentSchema = z.object({
+	type: z.enum(runEnvironmentTypes),
+	...remoteLocationSchema.shape,
+	["r-version"]: z.string().optional(),
+	["python-version"]: z.string().optional(),
+	["java-version"]: z.string().optional(),
+	envVars: z.array(z.string().regex(/=/, "environment variable should be specified in format: <var-name>=<var-value>, i.e.: MY_ENV=value")).optional(),
+	binDir: z.string()
+});
+const runDependencyJavaSchema = runEnvironmentSchema.extend({
+	type: z.literal("java"),
+	name: z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const runDependencyPythonSchema = runEnvironmentSchema.extend({
+	type: z.literal("python"),
+	["python-version"]: z.string(),
+	name: z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const runDependencyRSchema = runEnvironmentSchema.extend({
+	type: z.literal("R"),
+	["r-version"]: z.string(),
+	name: z.string().describe("name used to import this package as software dependency of tengo script")
+});
+const commonPackageSettingsSchema = z.object({
+	cmd: z.array(z.string()).min(1).describe("run given command, appended by args from workflow"),
+	envVars: z.array(z.string().regex(/=/, "full environment variable specification is required: <var-name>=<var-value>, e.g.: IS_CI=yes")).optional()
+});
+const binaryPackageSchema = z.object({
+	type: z.literal("binary"),
+	...commonPackageSettingsSchema.shape,
+	pkg: z.string().optional().describe("location of all package contents in Docker container (default: /app)")
+});
+const javaPackageSettingsSchema = z.object({
+	type: z.literal("java"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyJavaSchema
+});
+const pythonPackageSettingsSchema = z.object({
+	type: z.literal("python"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyPythonSchema,
+	toolset: z.string(),
+	dependencies: z.record(z.string(), z.string()).describe("paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'")
+});
+const rPackageSettingsSchema = z.object({
+	type: z.literal("R"),
+	...commonPackageSettingsSchema.shape,
+	runEnv: runDependencyRSchema,
+	toolset: z.string(),
+	dependencies: z.record(z.string(), z.string()).describe("paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'")
+});
+const condaPackageSchema = z.object({
+	type: z.literal("conda"),
+	...commonPackageSettingsSchema.shape,
+	["micromamba-version"]: z.string().describe("version of micromamba to be used to operate with conda environments"),
+	["conda-root-dir"]: z.string().default(CONDA_DATA_LOCATION).describe("root directory of conda environment inside package root"),
+	spec: z.string().describe("location of spec.yaml describing conda environment, relative to package root.")
+});
+const remoteSoftwareSchema = z.union([
+	remoteLocationSchema.extend(binaryPackageSchema.shape),
+	remoteLocationSchema.extend(javaPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(pythonPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(rPackageSettingsSchema.shape),
+	remoteLocationSchema.extend(condaPackageSchema.shape)
+]);
+const localLocationSchema = z.object({
+	hash: z.string().describe("hash of software directory. Makes deduplication to work properly when you actively develop software"),
+	path: z.string().describe("absolute path to root directory of software on local host")
+});
+const localSoftwareSchema = z.discriminatedUnion("type", [
+	localLocationSchema.extend(binaryPackageSchema.shape),
+	localLocationSchema.extend(javaPackageSettingsSchema.shape),
+	localLocationSchema.extend(pythonPackageSettingsSchema.shape),
+	localLocationSchema.extend(rPackageSettingsSchema.shape),
+	localLocationSchema.extend(condaPackageSchema.shape)
+]);
+const swJsonSchema = z.object({
+	isDev: z.boolean().optional(),
+	asset: assetSchema.optional(),
+	binary: remoteSoftwareSchema.optional(),
+	docker: dockerSchema.optional(),
+	runEnv: runEnvironmentSchema.optional(),
+	local: localSoftwareSchema.optional()
+}).refine((data) => toInt(data.runEnv) + toInt(data.binary || data.docker) + toInt(data.asset) + toInt(data.local) == 1, {
+	message: "entrypoint cannot point to several packages at once: choose 'environment', 'binary', 'asset', 'conda' or 'local'",
+	path: ["environment | binary | asset | conda | local"]
+});
+//#endregion
+export { swJsonSchema };
+
+//# sourceMappingURL=sw-json.js.map

package/dist/core/schemas/sw-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw-json.js","names":["defaults.DOCKER_PLACEHOLDER_PKG","artifacts.runEnvironmentTypes","defaults.CONDA_DATA_LOCATION","util.toInt"],"sources":["../../../src/core/schemas/sw-json.ts"],"sourcesContent":["import { z } from \"zod/v4\";\nimport * as defaults from \"../../defaults\";\nimport * as artifacts from \"./artifacts\";\nimport * as util from \"../util\";\n\nexport const remoteLocationSchema = z.object({\n  registry: z.string().describe(\"name of the registry to use for package download\"),\n  package: z\n    .string()\n    .describe(\"full package path in registry, e.g. 'common/jdk/21.0.2.13.1-{os}-{arch}.tgz\"),\n});\n\nexport const assetSchema = z.object({\n  ...remoteLocationSchema.shape,\n  url: z.string().describe(\"asset download URL\"),\n});\nexport type assetInfo = z.infer<typeof assetSchema>;\n\nexport const dockerSchema = z.object({\n  tag: z.string().describe(\"full image tag to pull on backend side to execute this software\"),\n  entrypoint: z.array(z.string()).describe(\"override image's entrypoint\"),\n  cmd: z.array(z.string()).describe(\"command to be run in the container\"),\n\n  pkg: z\n    .string()\n    .default(defaults.DOCKER_PLACEHOLDER_PKG)\n    .describe(\n      'what to substitute in place of \"{pkg}\" variable in \"cmd\" (for artifacts with docker autogeneration)',\n    ),\n});\nexport type dockerInfo = z.infer<typeof dockerSchema>;\n\nexport const runEnvironmentSchema = z.object({\n  type: z.enum(artifacts.runEnvironmentTypes),\n  ...remoteLocationSchema.shape,\n\n  [\"r-version\"]: z.string().optional(),\n  [\"python-version\"]: z.string().optional(),\n  [\"java-version\"]: z.string().optional(),\n\n  envVars: z\n    .array(\n      z\n        .string()\n        .regex(\n          /=/,\n          \"environment variable should be specified in format: <var-name>=<var-value>, i.e.: MY_ENV=value\",\n        ),\n    )\n    .optional(),\n\n  binDir: z.string(),\n});\nexport type runEnvInfo = z.infer<typeof runEnvironmentSchema>;\n\nexport const runDependencyJavaSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"java\"),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyJava = z.infer<typeof runDependencyJavaSchema>;\n\nexport const runDependencyPythonSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"python\"),\n  [\"python-version\"]: z.string(),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyPython = z.infer<typeof runDependencyPythonSchema>;\n\nexport const runDependencyRSchema = runEnvironmentSchema.extend({\n  type: z.literal(\"R\"),\n  [\"r-version\"]: z.string(),\n  name: z\n    .string()\n    .describe(\"name used to import this package as software dependency of tengo script\"),\n});\nexport type runEnvDependencyR = z.infer<typeof runDependencyRSchema>;\n\nexport type runEnvDependency = runEnvDependencyJava | runEnvDependencyPython | runEnvDependencyR;\n\nexport const commonPackageSettingsSchema = z.object({\n  cmd: z.array(z.string()).min(1).describe(\"run given command, appended by args from workflow\"),\n\n  envVars: z\n    .array(\n      z\n        .string()\n        .regex(\n          /=/,\n          \"full environment variable specification is required: <var-name>=<var-value>, e.g.: IS_CI=yes\",\n        ),\n    )\n    .optional(),\n});\n\nexport const binaryPackageSchema = z.object({\n  type: z.literal(\"binary\"),\n  ...commonPackageSettingsSchema.shape,\n\n  pkg: z\n    .string()\n    .optional()\n    .describe(\"location of all package contents in Docker container (default: /app)\"),\n});\n\nexport const javaPackageSettingsSchema = z.object({\n  type: z.literal(\"java\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyJavaSchema,\n});\n\nexport const pythonPackageSettingsSchema = z.object({\n  type: z.literal(\"python\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyPythonSchema,\n\n  toolset: z.string(),\n  dependencies: z\n    .record(z.string(), z.string())\n    .describe(\n      \"paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'\",\n    ),\n});\n\nexport const rPackageSettingsSchema = z.object({\n  type: z.literal(\"R\"),\n\n  ...commonPackageSettingsSchema.shape,\n  runEnv: runDependencyRSchema,\n\n  toolset: z.string(),\n  dependencies: z\n    .record(z.string(), z.string())\n    .describe(\n      \"paths of files that describe dependencies for given toolset: say, requirements.txt for 'pip'\",\n    ),\n});\n\nexport const condaPackageSchema = z.object({\n  type: z.literal(\"conda\"),\n  ...commonPackageSettingsSchema.shape,\n\n  [\"micromamba-version\"]: z\n    .string()\n    .describe(\"version of micromamba to be used to operate with conda environments\"),\n  [\"conda-root-dir\"]: z\n    .string()\n    .default(defaults.CONDA_DATA_LOCATION)\n    .describe(\"root directory of conda environment inside package root\"),\n\n  spec: z\n    .string()\n    .describe(\"location of spec.yaml describing conda environment, relative to package root.\"),\n});\n\nexport const remoteSoftwareSchema = z.union([\n  remoteLocationSchema.extend(binaryPackageSchema.shape),\n  remoteLocationSchema.extend(javaPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(pythonPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(rPackageSettingsSchema.shape),\n  remoteLocationSchema.extend(condaPackageSchema.shape),\n]);\nexport type remoteSoftwareType = z.infer<typeof remoteSoftwareSchema>;\n\nexport const localLocationSchema = z.object({\n  hash: z\n    .string()\n    .describe(\n      \"hash of software directory. Makes deduplication to work properly when you actively develop software\",\n    ),\n  path: z.string().describe(\"absolute path to root directory of software on local host\"),\n});\n\nexport const localSoftwareSchema = z.discriminatedUnion(\"type\", [\n  localLocationSchema.extend(binaryPackageSchema.shape),\n  localLocationSchema.extend(javaPackageSettingsSchema.shape),\n  localLocationSchema.extend(pythonPackageSettingsSchema.shape),\n  localLocationSchema.extend(rPackageSettingsSchema.shape),\n  localLocationSchema.extend(condaPackageSchema.shape),\n  // Docker can be used 'as usual' without any special 'local' section magic\n]);\nexport type localSoftwareType = z.infer<typeof localSoftwareSchema>;\n\n// Full .sw.json file schema\nexport const swJsonSchema = z\n  .object({\n    isDev: z.boolean().optional(),\n\n    asset: assetSchema.optional(),\n    binary: remoteSoftwareSchema.optional(),\n    docker: dockerSchema.optional(),\n    runEnv: runEnvironmentSchema.optional(),\n    local: localSoftwareSchema.optional(),\n  })\n  .refine(\n    (data) =>\n      util.toInt(data.runEnv) +\n        util.toInt(data.binary || data.docker) + // allow both docker and binary to be set in single entrypoint\n        util.toInt(data.asset) +\n        util.toInt(data.local) ==\n      1,\n    {\n      message:\n        \"entrypoint cannot point to several packages at once: choose 'environment', 'binary', 'asset', 'conda' or 'local'\",\n      path: [\"environment | binary | asset | conda | local\"],\n    },\n  );\n\nexport type swJsonType = z.infer<typeof swJsonSchema> & {\n  id: util.artifactID;\n};\n"],"mappings":"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"}

package/dist/core/storage.cjs

@@ -0,0 +1,86 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_util = require("./util.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_path_posix = require("node:path/posix");
+node_path_posix = require_runtime.__toESM(node_path_posix);
+let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
+let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
+//#region src/core/storage.ts
+async function objectExists(client, bucket, key) {
+	try {
+		await client.headObject({
+			Bucket: bucket,
+			Key: key
+		});
+		return true;
+	} catch (error) {
+		if (error instanceof Error && error.name === "NotFound") return false;
+		throw require_util.wrapErr(error, `failed to check if object exists in S3 bucket ${bucket}`);
+	}
+}
+async function newS3(options, bucket) {
+	const client = new _aws_sdk_client_s3.S3(options);
+	try {
+		await objectExists(client, bucket, "/");
+	} catch (error) {
+		throw require_util.CLIError(`credentials given to package builder do not have access to S3 bucket '${bucket}': ${error}`);
+	}
+	return client;
+}
+var S3Storage = class {
+	constructor(client, bucket, root = "") {
+		this.client = client;
+		this.bucket = bucket;
+		this.root = root;
+	}
+	async exists(file) {
+		return objectExists(this.client, this.bucket, node_path_posix.default.join(this.root, file));
+	}
+	async putFile(file, data) {
+		try {
+			await new _aws_sdk_lib_storage.Upload({
+				client: this.client,
+				params: {
+					Bucket: this.bucket,
+					Key: node_path_posix.default.join(this.root, file),
+					Body: data
+				}
+			}).done();
+		} catch (e) {
+			throw require_util.wrapErr(e, `failed to put object into S3 bucket ${this.bucket}`);
+		}
+	}
+};
+async function initByUrl(address, pkgRoot) {
+	if (address === "") throw require_util.CLIError(`Empty registry storage address`);
+	try {
+		const url = new URL(address, `file:${pkgRoot.split(node_path.default.sep).join(node_path_posix.default.sep)}/`);
+		switch (url.protocol) {
+			case "s3:": {
+				const s3Options = {};
+				const s3Region = url.searchParams.get("region");
+				if (s3Region) s3Options.region = s3Region;
+				const s3Bucket = url.hostname;
+				const s3KeyPrefix = require_util.trimPrefix(url.pathname, "/");
+				return new S3Storage(await newS3(s3Options, s3Bucket), s3Bucket, s3KeyPrefix);
+			}
+			case "s3e:": {
+				const s3eOptions = {};
+				const s3eRegion = url.searchParams.get("region");
+				if (s3eRegion) s3eOptions.region = s3eRegion;
+				const s3ePath = url.pathname.split("/").slice(1);
+				const s3eBucket = s3ePath[0];
+				const s3eKeyPrefix = s3ePath.length > 1 ? require_util.trimPrefix(s3ePath[1], "/") : "";
+				return new S3Storage(await newS3(s3eOptions, s3eBucket), s3eBucket, s3eKeyPrefix);
+			}
+			default: throw require_util.CLIError(`Protocol ${url.protocol} is not supported for software registries yet. Use your own tooling for package upload`);
+		}
+	} catch (e) {
+		throw require_util.wrapErr(e, `failed to init storage driver from URL`);
+	}
+}
+//#endregion
+exports.initByUrl = initByUrl;
+
+//# sourceMappingURL=storage.cjs.map

package/dist/core/storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.cjs","names":["S3","pathPosix","Upload","path"],"sources":["../../src/core/storage.ts"],"sourcesContent":["import pathPosix from \"node:path/posix\";\nimport { S3 } from \"@aws-sdk/client-s3\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport path from \"node:path\";\nimport * as util from \"./util\";\nimport type { Readable } from \"node:stream\";\n\nexport const supportedTypes = [\"S3\"] as const; // add other types when we support them\nexport type storageType = (typeof supportedTypes)[number];\n\nexport function typeToURLScheme(sType: storageType): string {\n  switch (sType) {\n    case \"S3\":\n      return \"s3\";\n    default:\n      util.assertNever(sType);\n      throw new Error(\"no schema defined for storage type\"); // just to calm down TS type analyzer\n  }\n}\n\nexport interface RegistryStorage {\n  exists(file: string): Promise<boolean>;\n  putFile(file: string, data: Buffer | Readable): Promise<void>;\n}\n\nasync function objectExists(client: S3, bucket: string, key: string): Promise<boolean> {\n  try {\n    await client.headObject({\n      Bucket: bucket,\n      Key: key,\n    });\n\n    return true;\n  } catch (error) {\n    if (error instanceof Error && error.name === \"NotFound\") {\n      return false;\n    }\n\n    throw util.wrapErr(error, `failed to check if object exists in S3 bucket ${bucket}`);\n  }\n}\n\nasync function newS3(\n  options: NonNullable<ConstructorParameters<typeof S3>[0]>,\n  bucket: string,\n): Promise<S3> {\n  const client = new S3(options);\n\n  try {\n    await objectExists(client, bucket, \"/\");\n  } catch (error) {\n    throw util.CLIError(\n      `credentials given to package builder do not have access to S3 bucket '${bucket}': ${error}`,\n    );\n  }\n\n  return client;\n}\n\nexport class S3Storage implements RegistryStorage {\n  constructor(\n    public readonly client: S3,\n    public readonly bucket: string,\n    public readonly root: string = \"\",\n  ) {}\n\n  async exists(file: string): Promise<boolean> {\n    return objectExists(this.client, this.bucket, pathPosix.join(this.root, file));\n  }\n\n  async putFile(file: string, data: Buffer | Readable): Promise<void> {\n    try {\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.bucket,\n          Key: pathPosix.join(this.root, file),\n          Body: data,\n        },\n      });\n\n      await upload.done();\n    } catch (e) {\n      throw util.wrapErr(e, `failed to put object into S3 bucket ${this.bucket}`);\n    }\n  }\n}\n\nexport async function initByUrl(address: string, pkgRoot: string): Promise<RegistryStorage> {\n  if (address === \"\") {\n    throw util.CLIError(`Empty registry storage address`);\n  }\n\n  try {\n    const url = new URL(address, `file:${pkgRoot.split(path.sep).join(pathPosix.sep)}/`);\n    switch (url.protocol) {\n      case \"s3:\": {\n        const s3Options: NonNullable<ConstructorParameters<typeof S3>[0]> = {};\n        const s3Region = url.searchParams.get(\"region\");\n        if (s3Region) s3Options.region = s3Region;\n        const s3Bucket = url.hostname;\n        const s3KeyPrefix = util.trimPrefix(url.pathname, \"/\");\n        const s3Client = await newS3(s3Options, s3Bucket);\n        return new S3Storage(s3Client, s3Bucket, s3KeyPrefix);\n      }\n      case \"s3e:\": {\n        const s3eOptions: NonNullable<ConstructorParameters<typeof S3>[0]> = {};\n        const s3eRegion = url.searchParams.get(\"region\");\n        if (s3eRegion) s3eOptions.region = s3eRegion;\n\n        const s3ePath = url.pathname.split(\"/\").slice(1); // '/bucket/keyPrefix' -> ['', 'bucket', 'keyPrefix'] -> ['bucket', 'keyPrefix']\n        const s3eBucket = s3ePath[0];\n        const s3eKeyPrefix = s3ePath.length > 1 ? util.trimPrefix(s3ePath[1], \"/\") : \"\";\n        const s3eClient = await newS3(s3eOptions, s3eBucket);\n        return new S3Storage(s3eClient, s3eBucket, s3eKeyPrefix);\n      }\n      default:\n        throw util.CLIError(\n          `Protocol ${url.protocol} is not supported for software registries yet. Use your own tooling for package upload`,\n        );\n    }\n  } catch (e) {\n    throw util.wrapErr(e, `failed to init storage driver from URL`);\n  }\n}\n"],"mappings":";;;;;;;;;AAyBA,eAAe,aAAa,QAAY,QAAgB,KAA+B;AACrF,KAAI;AACF,QAAM,OAAO,WAAW;GACtB,QAAQ;GACR,KAAK;GACN,CAAC;AAEF,SAAO;UACA,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,WAC3C,QAAO;AAGT,QAAA,aAAA,QAAmB,OAAO,iDAAiD,SAAS;;;AAIxF,eAAe,MACb,SACA,QACa;CACb,MAAM,SAAS,IAAIA,mBAAAA,GAAG,QAAQ;AAE9B,KAAI;AACF,QAAM,aAAa,QAAQ,QAAQ,IAAI;UAChC,OAAO;AACd,QAAA,aAAA,SACE,yEAAyE,OAAO,KAAK,QACtF;;AAGH,QAAO;;AAGT,IAAa,YAAb,MAAkD;CAChD,YACE,QACA,QACA,OAA+B,IAC/B;AAHgB,OAAA,SAAA;AACA,OAAA,SAAA;AACA,OAAA,OAAA;;CAGlB,MAAM,OAAO,MAAgC;AAC3C,SAAO,aAAa,KAAK,QAAQ,KAAK,QAAQC,gBAAAA,QAAU,KAAK,KAAK,MAAM,KAAK,CAAC;;CAGhF,MAAM,QAAQ,MAAc,MAAwC;AAClE,MAAI;AAUF,SATe,IAAIC,qBAAAA,OAAO;IACxB,QAAQ,KAAK;IACb,QAAQ;KACN,QAAQ,KAAK;KACb,KAAKD,gBAAAA,QAAU,KAAK,KAAK,MAAM,KAAK;KACpC,MAAM;KACP;IACF,CAAC,CAEW,MAAM;WACZ,GAAG;AACV,SAAA,aAAA,QAAmB,GAAG,uCAAuC,KAAK,SAAS;;;;AAKjF,eAAsB,UAAU,SAAiB,SAA2C;AAC1F,KAAI,YAAY,GACd,OAAA,aAAA,SAAoB,iCAAiC;AAGvD,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,SAAS,QAAQ,QAAQ,MAAME,UAAAA,QAAK,IAAI,CAAC,KAAKF,gBAAAA,QAAU,IAAI,CAAC,GAAG;AACpF,UAAQ,IAAI,UAAZ;GACE,KAAK,OAAO;IACV,MAAM,YAA8D,EAAE;IACtE,MAAM,WAAW,IAAI,aAAa,IAAI,SAAS;AAC/C,QAAI,SAAU,WAAU,SAAS;IACjC,MAAM,WAAW,IAAI;IACrB,MAAM,cAAA,aAAA,WAA8B,IAAI,UAAU,IAAI;AAEtD,WAAO,IAAI,UADM,MAAM,MAAM,WAAW,SAAS,EAClB,UAAU,YAAY;;GAEvD,KAAK,QAAQ;IACX,MAAM,aAA+D,EAAE;IACvE,MAAM,YAAY,IAAI,aAAa,IAAI,SAAS;AAChD,QAAI,UAAW,YAAW,SAAS;IAEnC,MAAM,UAAU,IAAI,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE;IAChD,MAAM,YAAY,QAAQ;IAC1B,MAAM,eAAe,QAAQ,SAAS,IAAA,aAAA,WAAoB,QAAQ,IAAI,IAAI,GAAG;AAE7E,WAAO,IAAI,UADO,MAAM,MAAM,YAAY,UAAU,EACpB,WAAW,aAAa;;GAE1D,QACE,OAAA,aAAA,SACE,YAAY,IAAI,SAAS,wFAC1B;;UAEE,GAAG;AACV,QAAA,aAAA,QAAmB,GAAG,yCAAyC"}

package/dist/core/storage.js

@@ -0,0 +1,83 @@
+import { CLIError, trimPrefix, wrapErr } from "./util.js";
+import path from "node:path";
+import pathPosix from "node:path/posix";
+import { S3 } from "@aws-sdk/client-s3";
+import { Upload } from "@aws-sdk/lib-storage";
+//#region src/core/storage.ts
+async function objectExists(client, bucket, key) {
+	try {
+		await client.headObject({
+			Bucket: bucket,
+			Key: key
+		});
+		return true;
+	} catch (error) {
+		if (error instanceof Error && error.name === "NotFound") return false;
+		throw wrapErr(error, `failed to check if object exists in S3 bucket ${bucket}`);
+	}
+}
+async function newS3(options, bucket) {
+	const client = new S3(options);
+	try {
+		await objectExists(client, bucket, "/");
+	} catch (error) {
+		throw CLIError(`credentials given to package builder do not have access to S3 bucket '${bucket}': ${error}`);
+	}
+	return client;
+}
+var S3Storage = class {
+	constructor(client, bucket, root = "") {
+		this.client = client;
+		this.bucket = bucket;
+		this.root = root;
+	}
+	async exists(file) {
+		return objectExists(this.client, this.bucket, pathPosix.join(this.root, file));
+	}
+	async putFile(file, data) {
+		try {
+			await new Upload({
+				client: this.client,
+				params: {
+					Bucket: this.bucket,
+					Key: pathPosix.join(this.root, file),
+					Body: data
+				}
+			}).done();
+		} catch (e) {
+			throw wrapErr(e, `failed to put object into S3 bucket ${this.bucket}`);
+		}
+	}
+};
+async function initByUrl(address, pkgRoot) {
+	if (address === "") throw CLIError(`Empty registry storage address`);
+	try {
+		const url = new URL(address, `file:${pkgRoot.split(path.sep).join(pathPosix.sep)}/`);
+		switch (url.protocol) {
+			case "s3:": {
+				const s3Options = {};
+				const s3Region = url.searchParams.get("region");
+				if (s3Region) s3Options.region = s3Region;
+				const s3Bucket = url.hostname;
+				const s3KeyPrefix = trimPrefix(url.pathname, "/");
+				return new S3Storage(await newS3(s3Options, s3Bucket), s3Bucket, s3KeyPrefix);
+			}
+			case "s3e:": {
+				const s3eOptions = {};
+				const s3eRegion = url.searchParams.get("region");
+				if (s3eRegion) s3eOptions.region = s3eRegion;
+				const s3ePath = url.pathname.split("/").slice(1);
+				const s3eBucket = s3ePath[0];
+				const s3eKeyPrefix = s3ePath.length > 1 ? trimPrefix(s3ePath[1], "/") : "";
+				return new S3Storage(await newS3(s3eOptions, s3eBucket), s3eBucket, s3eKeyPrefix);
+			}
+			default: throw CLIError(`Protocol ${url.protocol} is not supported for software registries yet. Use your own tooling for package upload`);
+		}
+	} catch (e) {
+		throw wrapErr(e, `failed to init storage driver from URL`);
+	}
+}
+//#endregion
+export { initByUrl };
+
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","names":["util.wrapErr","util.CLIError","util.trimPrefix"],"sources":["../../src/core/storage.ts"],"sourcesContent":["import pathPosix from \"node:path/posix\";\nimport { S3 } from \"@aws-sdk/client-s3\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport path from \"node:path\";\nimport * as util from \"./util\";\nimport type { Readable } from \"node:stream\";\n\nexport const supportedTypes = [\"S3\"] as const; // add other types when we support them\nexport type storageType = (typeof supportedTypes)[number];\n\nexport function typeToURLScheme(sType: storageType): string {\n  switch (sType) {\n    case \"S3\":\n      return \"s3\";\n    default:\n      util.assertNever(sType);\n      throw new Error(\"no schema defined for storage type\"); // just to calm down TS type analyzer\n  }\n}\n\nexport interface RegistryStorage {\n  exists(file: string): Promise<boolean>;\n  putFile(file: string, data: Buffer | Readable): Promise<void>;\n}\n\nasync function objectExists(client: S3, bucket: string, key: string): Promise<boolean> {\n  try {\n    await client.headObject({\n      Bucket: bucket,\n      Key: key,\n    });\n\n    return true;\n  } catch (error) {\n    if (error instanceof Error && error.name === \"NotFound\") {\n      return false;\n    }\n\n    throw util.wrapErr(error, `failed to check if object exists in S3 bucket ${bucket}`);\n  }\n}\n\nasync function newS3(\n  options: NonNullable<ConstructorParameters<typeof S3>[0]>,\n  bucket: string,\n): Promise<S3> {\n  const client = new S3(options);\n\n  try {\n    await objectExists(client, bucket, \"/\");\n  } catch (error) {\n    throw util.CLIError(\n      `credentials given to package builder do not have access to S3 bucket '${bucket}': ${error}`,\n    );\n  }\n\n  return client;\n}\n\nexport class S3Storage implements RegistryStorage {\n  constructor(\n    public readonly client: S3,\n    public readonly bucket: string,\n    public readonly root: string = \"\",\n  ) {}\n\n  async exists(file: string): Promise<boolean> {\n    return objectExists(this.client, this.bucket, pathPosix.join(this.root, file));\n  }\n\n  async putFile(file: string, data: Buffer | Readable): Promise<void> {\n    try {\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.bucket,\n          Key: pathPosix.join(this.root, file),\n          Body: data,\n        },\n      });\n\n      await upload.done();\n    } catch (e) {\n      throw util.wrapErr(e, `failed to put object into S3 bucket ${this.bucket}`);\n    }\n  }\n}\n\nexport async function initByUrl(address: string, pkgRoot: string): Promise<RegistryStorage> {\n  if (address === \"\") {\n    throw util.CLIError(`Empty registry storage address`);\n  }\n\n  try {\n    const url = new URL(address, `file:${pkgRoot.split(path.sep).join(pathPosix.sep)}/`);\n    switch (url.protocol) {\n      case \"s3:\": {\n        const s3Options: NonNullable<ConstructorParameters<typeof S3>[0]> = {};\n        const s3Region = url.searchParams.get(\"region\");\n        if (s3Region) s3Options.region = s3Region;\n        const s3Bucket = url.hostname;\n        const s3KeyPrefix = util.trimPrefix(url.pathname, \"/\");\n        const s3Client = await newS3(s3Options, s3Bucket);\n        return new S3Storage(s3Client, s3Bucket, s3KeyPrefix);\n      }\n      case \"s3e:\": {\n        const s3eOptions: NonNullable<ConstructorParameters<typeof S3>[0]> = {};\n        const s3eRegion = url.searchParams.get(\"region\");\n        if (s3eRegion) s3eOptions.region = s3eRegion;\n\n        const s3ePath = url.pathname.split(\"/\").slice(1); // '/bucket/keyPrefix' -> ['', 'bucket', 'keyPrefix'] -> ['bucket', 'keyPrefix']\n        const s3eBucket = s3ePath[0];\n        const s3eKeyPrefix = s3ePath.length > 1 ? util.trimPrefix(s3ePath[1], \"/\") : \"\";\n        const s3eClient = await newS3(s3eOptions, s3eBucket);\n        return new S3Storage(s3eClient, s3eBucket, s3eKeyPrefix);\n      }\n      default:\n        throw util.CLIError(\n          `Protocol ${url.protocol} is not supported for software registries yet. Use your own tooling for package upload`,\n        );\n    }\n  } catch (e) {\n    throw util.wrapErr(e, `failed to init storage driver from URL`);\n  }\n}\n"],"mappings":";;;;;;AAyBA,eAAe,aAAa,QAAY,QAAgB,KAA+B;AACrF,KAAI;AACF,QAAM,OAAO,WAAW;GACtB,QAAQ;GACR,KAAK;GACN,CAAC;AAEF,SAAO;UACA,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,WAC3C,QAAO;AAGT,QAAMA,QAAa,OAAO,iDAAiD,SAAS;;;AAIxF,eAAe,MACb,SACA,QACa;CACb,MAAM,SAAS,IAAI,GAAG,QAAQ;AAE9B,KAAI;AACF,QAAM,aAAa,QAAQ,QAAQ,IAAI;UAChC,OAAO;AACd,QAAMC,SACJ,yEAAyE,OAAO,KAAK,QACtF;;AAGH,QAAO;;AAGT,IAAa,YAAb,MAAkD;CAChD,YACE,QACA,QACA,OAA+B,IAC/B;AAHgB,OAAA,SAAA;AACA,OAAA,SAAA;AACA,OAAA,OAAA;;CAGlB,MAAM,OAAO,MAAgC;AAC3C,SAAO,aAAa,KAAK,QAAQ,KAAK,QAAQ,UAAU,KAAK,KAAK,MAAM,KAAK,CAAC;;CAGhF,MAAM,QAAQ,MAAc,MAAwC;AAClE,MAAI;AAUF,SATe,IAAI,OAAO;IACxB,QAAQ,KAAK;IACb,QAAQ;KACN,QAAQ,KAAK;KACb,KAAK,UAAU,KAAK,KAAK,MAAM,KAAK;KACpC,MAAM;KACP;IACF,CAAC,CAEW,MAAM;WACZ,GAAG;AACV,SAAMD,QAAa,GAAG,uCAAuC,KAAK,SAAS;;;;AAKjF,eAAsB,UAAU,SAAiB,SAA2C;AAC1F,KAAI,YAAY,GACd,OAAMC,SAAc,iCAAiC;AAGvD,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,SAAS,QAAQ,QAAQ,MAAM,KAAK,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,GAAG;AACpF,UAAQ,IAAI,UAAZ;GACE,KAAK,OAAO;IACV,MAAM,YAA8D,EAAE;IACtE,MAAM,WAAW,IAAI,aAAa,IAAI,SAAS;AAC/C,QAAI,SAAU,WAAU,SAAS;IACjC,MAAM,WAAW,IAAI;IACrB,MAAM,cAAcC,WAAgB,IAAI,UAAU,IAAI;AAEtD,WAAO,IAAI,UADM,MAAM,MAAM,WAAW,SAAS,EAClB,UAAU,YAAY;;GAEvD,KAAK,QAAQ;IACX,MAAM,aAA+D,EAAE;IACvE,MAAM,YAAY,IAAI,aAAa,IAAI,SAAS;AAChD,QAAI,UAAW,YAAW,SAAS;IAEnC,MAAM,UAAU,IAAI,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE;IAChD,MAAM,YAAY,QAAQ;IAC1B,MAAM,eAAe,QAAQ,SAAS,IAAIA,WAAgB,QAAQ,IAAI,IAAI,GAAG;AAE7E,WAAO,IAAI,UADO,MAAM,MAAM,YAAY,UAAU,EACpB,WAAW,aAAa;;GAE1D,QACE,OAAMD,SACJ,YAAY,IAAI,SAAS,wFAC1B;;UAEE,GAAG;AACV,QAAMD,QAAa,GAAG,yCAAyC"}