@opys/core 0.1.2

package/dist/index.d.cts

@@ -0,0 +1,256 @@
+import { z } from "zod";
+import * as napi from "@opys/core-binding";
+
+//#region lib/fetch.d.ts
+/**
+ * Wrap `fetch()` with bounded retry on transient network failures and
+ * 5xx-class responses. Errors that won't recover from a retry (4xx,
+ * `AbortError`, JSON parse failures downstream of the response) are
+ * surfaced unchanged so callers handle them with their own logic.
+ *
+ * Network-level retries cover the AggregateError ETIMEDOUT / ECONNRESET
+ * / ENOTFOUND / EAI_AGAIN / ECONNREFUSED cases that node:undici reports
+ * as `TypeError: fetch failed` with a populated `cause`. Without this
+ * one DNS hiccup mid-`opys launch` aborts the whole config evaluation.
+ */
+/**
+ * Default `User-Agent` for every opys HTTP request. The bare `undici`
+ * agent gets rejected or rate-limited by some CDNs and by the CurseForge
+ * API, so we identify ourselves. The patch component is omitted so the
+ * string doesn't churn against `package.json` on every release.
+ */
+declare const OPYS_USER_AGENT = "opys/1.0";
+interface FetchRetryOptions {
+  /** Total attempts including the first. Default 4 (so up to 3 retries). */
+  attempts?: number;
+  /** Initial delay before retry #2, in ms. Default 250. */
+  baseDelayMs?: number;
+  /** Cap on per-attempt delay, in ms. Default 5000. */
+  maxDelayMs?: number;
+  /** HTTP status codes that trigger a retry. Default 408, 425, 429, 500, 502, 503, 504. */
+  retryStatuses?: ReadonlySet<number> | readonly number[];
+  /** Forward to the underlying `fetch`'s signal — abort cancels remaining retries. */
+  signal?: AbortSignal;
+  /** Callback for diagnostics / logging on each retry. */
+  onRetry?: (info: {
+    attempt: number;
+    delayMs: number;
+    error?: unknown;
+    status?: number;
+  }) => void;
+}
+declare function fetchWithRetry(input: string | URL, init?: RequestInit, retry?: FetchRetryOptions): Promise<Response>;
+//#endregion
+//#region lib/index.d.ts
+declare const OsNameSchema: z.ZodEnum<{
+  linux: "linux";
+  windows: "windows";
+  osx: "osx";
+}>;
+declare const OsArchSchema: z.ZodEnum<{
+  x86: "x86";
+  x86_64: "x86_64";
+  arm: "arm";
+  aarch64: "aarch64";
+  any: "any";
+}>;
+declare const RuleSchema: z.ZodUnion<readonly [z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+  os: z.ZodObject<{
+    name: z.ZodOptional<z.ZodEnum<{
+      linux: "linux";
+      windows: "windows";
+      osx: "osx";
+    }>>;
+    version: z.ZodOptional<z.ZodString>;
+    arch: z.ZodOptional<z.ZodEnum<{
+      x86: "x86";
+      x86_64: "x86_64";
+      arm: "arm";
+      aarch64: "aarch64";
+      any: "any";
+    }>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+  features: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+}, z.core.$strip>]>;
+declare function decodeManifest(wire: unknown): Manifest;
+declare function encodeManifest(domain: Manifest): unknown;
+declare function parseManifest(input: string): Manifest;
+declare function filterManifest(manifest: Manifest, platform: OsOptions, features?: string[]): Manifest;
+declare function resolveVars(vars: Record<string, string>): Record<string, string>;
+declare function interpolate(template: string, vars: Record<string, string>): string;
+declare function resolvedArgs(launch: Launch, platform: OsOptions, features?: string[]): string[];
+declare function resolvedEnvs(launch: Launch, platform: OsOptions, features?: string[]): Record<string, string>;
+declare function satisfiesRuleset(rules: Ruleset | string | unknown, platform: OsOptions, features?: string[]): boolean;
+declare function globBase(glob: string): string;
+declare function globToRegexSource(glob: string): string;
+/** Compile a glob to a real `RegExp` (the binding returns the source string). */
+declare function globToRegex(glob: string): RegExp;
+type OsOptions = napi.OsOptions;
+type OsName = 'linux' | 'windows' | 'osx';
+type OsArch = 'x86' | 'x86_64' | 'arm' | 'aarch64' | 'any';
+interface OsConstraint {
+  readonly name?: OsName;
+  readonly version?: string;
+  readonly arch?: OsArch;
+}
+type RuleAction = 'allow' | 'disallow';
+type FeatureConstraint = Record<string, boolean>;
+type Rule = {
+  action: RuleAction;
+  os: OsConstraint;
+} | {
+  action: RuleAction;
+  features: FeatureConstraint;
+} | {
+  action: RuleAction;
+};
+type Ruleset = Rule[];
+type Source = {
+  readonly kind: 'url';
+  readonly url: string;
+} | {
+  readonly kind: 'file';
+  readonly file: string;
+} | {
+  readonly kind: 'string';
+  readonly string: string;
+} | {
+  readonly kind: 'bytes';
+  readonly bytes: string;
+} | {
+  readonly kind: 'pointer';
+  readonly pointer: string;
+};
+type HashEntry = {
+  sha1: string;
+} | {
+  sha256: string;
+} | {
+  md5: string;
+};
+type Integrity = HashEntry | HashEntry[];
+type HashAlgo = 'sha1' | 'sha256' | 'md5';
+type HashRef = {
+  readonly sha256: string;
+} | {
+  readonly sha1: string;
+} | {
+  readonly md5: string;
+};
+interface IntegrityProbes {
+  readonly header?: HashRef;
+  readonly url?: HashRef;
+}
+interface SizeProbes {
+  readonly header?: string;
+}
+interface Discovery {
+  readonly integrity?: IntegrityProbes;
+  readonly size?: SizeProbes;
+}
+interface ExtractPick {
+  readonly kind: 'pick';
+  readonly file: string;
+  readonly into: string;
+}
+interface ExtractScan {
+  readonly kind: 'scan';
+  readonly matches: string;
+  readonly into: string;
+  readonly strip?: string[];
+  readonly includes?: string[];
+  readonly excludes?: string[];
+}
+interface ExtractDump {
+  readonly kind: 'dump';
+  readonly into: string;
+  readonly clean?: boolean;
+  readonly includes?: string[];
+  readonly excludes?: string[];
+}
+type ExtractRule = ExtractPick | ExtractScan | ExtractDump;
+interface Artifact {
+  readonly path: string;
+  readonly source: Source;
+  readonly size?: number;
+  readonly rules: Ruleset;
+  readonly integrity?: Integrity;
+  readonly discovery?: Discovery;
+  readonly metadata?: unknown;
+  readonly extract?: ExtractRule[];
+}
+interface Val {
+  readonly rules: Ruleset;
+  readonly value: string[];
+}
+type Valset = Val[];
+interface ConditionalVal {
+  readonly value: string;
+  readonly rules: Ruleset;
+}
+type ValDefs = Readonly<Record<string, string | readonly ConditionalVal[]>>;
+interface Launch {
+  readonly command: string;
+  readonly workdir: string;
+  readonly args: Valset;
+  readonly envs: ValDefs;
+}
+interface Manifest {
+  readonly vars: ValDefs;
+  readonly launch?: Launch;
+  readonly artifacts: ReadonlyArray<Artifact>;
+  readonly restrict?: ReadonlyArray<string>;
+}
+interface PointerDescriptor {
+  readonly source: Source;
+  readonly integrity?: Integrity;
+  readonly size?: number;
+}
+declare const sourceUrl: (url: string) => Source;
+declare const sourceFile: (file: string) => Source;
+declare const sourceString: (string: string) => Source;
+declare const sourcePointer: (pointer: string) => Source;
+declare const sourceBytes: (bytes: Uint8Array) => Source;
+declare const isSourceUrl: (s: Source) => s is Extract<Source, {
+  kind: "url";
+}>;
+declare const isSourceFile: (s: Source) => s is Extract<Source, {
+  kind: "file";
+}>;
+declare const isSourceString: (s: Source) => s is Extract<Source, {
+  kind: "string";
+}>;
+declare const isSourceBytes: (s: Source) => s is Extract<Source, {
+  kind: "bytes";
+}>;
+declare const isSourcePointer: (s: Source) => s is Extract<Source, {
+  kind: "pointer";
+}>;
+declare const extractPick: (file: string, into: string) => ExtractPick;
+declare const extractScan: (matches: string, into: string, opts?: Omit<ExtractScan, "kind" | "matches" | "into">) => ExtractScan;
+declare const extractDump: (into: string, opts?: Omit<ExtractDump, "kind" | "into">) => ExtractDump;
+declare const emptyRuleset: () => Ruleset;
+declare const allowOsRuleset: (name: OsName) => Ruleset;
+/** Deduplicate by normalized (posix) path; later entries win. */
+declare function deduplicateArtifacts(artifacts: Artifact[]): Artifact[];
+type RawSingle = string | Rule;
+type RawRuleset = RawSingle | RawSingle[];
+declare function parseShortRuleset(raw: RawRuleset): Ruleset;
+declare function parseValset(raw: unknown): Valset;
+//#endregion
+export { Artifact, ConditionalVal, Discovery, ExtractDump, ExtractPick, ExtractRule, ExtractScan, FeatureConstraint, type FetchRetryOptions, HashAlgo, HashEntry, HashRef, Integrity, IntegrityProbes, Launch, Manifest, OPYS_USER_AGENT, OsArch, OsArchSchema, OsConstraint, OsName, OsNameSchema, OsOptions, PointerDescriptor, Rule, RuleAction, RuleSchema, Ruleset, SizeProbes, Source, Val, ValDefs, Valset, allowOsRuleset, decodeManifest, deduplicateArtifacts, emptyRuleset, encodeManifest, extractDump, extractPick, extractScan, fetchWithRetry, filterManifest, globBase, globToRegex, globToRegexSource, interpolate, isSourceBytes, isSourceFile, isSourcePointer, isSourceString, isSourceUrl, parseManifest, parseShortRuleset, parseValset, resolveVars, resolvedArgs, resolvedEnvs, satisfiesRuleset, sourceBytes, sourceFile, sourcePointer, sourceString, sourceUrl };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

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

package/dist/index.d.mts

@@ -0,0 +1,256 @@
+import { z } from "zod";
+import * as napi from "@opys/core-binding";
+
+//#region lib/fetch.d.ts
+/**
+ * Wrap `fetch()` with bounded retry on transient network failures and
+ * 5xx-class responses. Errors that won't recover from a retry (4xx,
+ * `AbortError`, JSON parse failures downstream of the response) are
+ * surfaced unchanged so callers handle them with their own logic.
+ *
+ * Network-level retries cover the AggregateError ETIMEDOUT / ECONNRESET
+ * / ENOTFOUND / EAI_AGAIN / ECONNREFUSED cases that node:undici reports
+ * as `TypeError: fetch failed` with a populated `cause`. Without this
+ * one DNS hiccup mid-`opys launch` aborts the whole config evaluation.
+ */
+/**
+ * Default `User-Agent` for every opys HTTP request. The bare `undici`
+ * agent gets rejected or rate-limited by some CDNs and by the CurseForge
+ * API, so we identify ourselves. The patch component is omitted so the
+ * string doesn't churn against `package.json` on every release.
+ */
+declare const OPYS_USER_AGENT = "opys/1.0";
+interface FetchRetryOptions {
+  /** Total attempts including the first. Default 4 (so up to 3 retries). */
+  attempts?: number;
+  /** Initial delay before retry #2, in ms. Default 250. */
+  baseDelayMs?: number;
+  /** Cap on per-attempt delay, in ms. Default 5000. */
+  maxDelayMs?: number;
+  /** HTTP status codes that trigger a retry. Default 408, 425, 429, 500, 502, 503, 504. */
+  retryStatuses?: ReadonlySet<number> | readonly number[];
+  /** Forward to the underlying `fetch`'s signal — abort cancels remaining retries. */
+  signal?: AbortSignal;
+  /** Callback for diagnostics / logging on each retry. */
+  onRetry?: (info: {
+    attempt: number;
+    delayMs: number;
+    error?: unknown;
+    status?: number;
+  }) => void;
+}
+declare function fetchWithRetry(input: string | URL, init?: RequestInit, retry?: FetchRetryOptions): Promise<Response>;
+//#endregion
+//#region lib/index.d.ts
+declare const OsNameSchema: z.ZodEnum<{
+  linux: "linux";
+  windows: "windows";
+  osx: "osx";
+}>;
+declare const OsArchSchema: z.ZodEnum<{
+  x86: "x86";
+  x86_64: "x86_64";
+  arm: "arm";
+  aarch64: "aarch64";
+  any: "any";
+}>;
+declare const RuleSchema: z.ZodUnion<readonly [z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+  os: z.ZodObject<{
+    name: z.ZodOptional<z.ZodEnum<{
+      linux: "linux";
+      windows: "windows";
+      osx: "osx";
+    }>>;
+    version: z.ZodOptional<z.ZodString>;
+    arch: z.ZodOptional<z.ZodEnum<{
+      x86: "x86";
+      x86_64: "x86_64";
+      arm: "arm";
+      aarch64: "aarch64";
+      any: "any";
+    }>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+  features: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodEnum<{
+    allow: "allow";
+    disallow: "disallow";
+  }>;
+}, z.core.$strip>]>;
+declare function decodeManifest(wire: unknown): Manifest;
+declare function encodeManifest(domain: Manifest): unknown;
+declare function parseManifest(input: string): Manifest;
+declare function filterManifest(manifest: Manifest, platform: OsOptions, features?: string[]): Manifest;
+declare function resolveVars(vars: Record<string, string>): Record<string, string>;
+declare function interpolate(template: string, vars: Record<string, string>): string;
+declare function resolvedArgs(launch: Launch, platform: OsOptions, features?: string[]): string[];
+declare function resolvedEnvs(launch: Launch, platform: OsOptions, features?: string[]): Record<string, string>;
+declare function satisfiesRuleset(rules: Ruleset | string | unknown, platform: OsOptions, features?: string[]): boolean;
+declare function globBase(glob: string): string;
+declare function globToRegexSource(glob: string): string;
+/** Compile a glob to a real `RegExp` (the binding returns the source string). */
+declare function globToRegex(glob: string): RegExp;
+type OsOptions = napi.OsOptions;
+type OsName = 'linux' | 'windows' | 'osx';
+type OsArch = 'x86' | 'x86_64' | 'arm' | 'aarch64' | 'any';
+interface OsConstraint {
+  readonly name?: OsName;
+  readonly version?: string;
+  readonly arch?: OsArch;
+}
+type RuleAction = 'allow' | 'disallow';
+type FeatureConstraint = Record<string, boolean>;
+type Rule = {
+  action: RuleAction;
+  os: OsConstraint;
+} | {
+  action: RuleAction;
+  features: FeatureConstraint;
+} | {
+  action: RuleAction;
+};
+type Ruleset = Rule[];
+type Source = {
+  readonly kind: 'url';
+  readonly url: string;
+} | {
+  readonly kind: 'file';
+  readonly file: string;
+} | {
+  readonly kind: 'string';
+  readonly string: string;
+} | {
+  readonly kind: 'bytes';
+  readonly bytes: string;
+} | {
+  readonly kind: 'pointer';
+  readonly pointer: string;
+};
+type HashEntry = {
+  sha1: string;
+} | {
+  sha256: string;
+} | {
+  md5: string;
+};
+type Integrity = HashEntry | HashEntry[];
+type HashAlgo = 'sha1' | 'sha256' | 'md5';
+type HashRef = {
+  readonly sha256: string;
+} | {
+  readonly sha1: string;
+} | {
+  readonly md5: string;
+};
+interface IntegrityProbes {
+  readonly header?: HashRef;
+  readonly url?: HashRef;
+}
+interface SizeProbes {
+  readonly header?: string;
+}
+interface Discovery {
+  readonly integrity?: IntegrityProbes;
+  readonly size?: SizeProbes;
+}
+interface ExtractPick {
+  readonly kind: 'pick';
+  readonly file: string;
+  readonly into: string;
+}
+interface ExtractScan {
+  readonly kind: 'scan';
+  readonly matches: string;
+  readonly into: string;
+  readonly strip?: string[];
+  readonly includes?: string[];
+  readonly excludes?: string[];
+}
+interface ExtractDump {
+  readonly kind: 'dump';
+  readonly into: string;
+  readonly clean?: boolean;
+  readonly includes?: string[];
+  readonly excludes?: string[];
+}
+type ExtractRule = ExtractPick | ExtractScan | ExtractDump;
+interface Artifact {
+  readonly path: string;
+  readonly source: Source;
+  readonly size?: number;
+  readonly rules: Ruleset;
+  readonly integrity?: Integrity;
+  readonly discovery?: Discovery;
+  readonly metadata?: unknown;
+  readonly extract?: ExtractRule[];
+}
+interface Val {
+  readonly rules: Ruleset;
+  readonly value: string[];
+}
+type Valset = Val[];
+interface ConditionalVal {
+  readonly value: string;
+  readonly rules: Ruleset;
+}
+type ValDefs = Readonly<Record<string, string | readonly ConditionalVal[]>>;
+interface Launch {
+  readonly command: string;
+  readonly workdir: string;
+  readonly args: Valset;
+  readonly envs: ValDefs;
+}
+interface Manifest {
+  readonly vars: ValDefs;
+  readonly launch?: Launch;
+  readonly artifacts: ReadonlyArray<Artifact>;
+  readonly restrict?: ReadonlyArray<string>;
+}
+interface PointerDescriptor {
+  readonly source: Source;
+  readonly integrity?: Integrity;
+  readonly size?: number;
+}
+declare const sourceUrl: (url: string) => Source;
+declare const sourceFile: (file: string) => Source;
+declare const sourceString: (string: string) => Source;
+declare const sourcePointer: (pointer: string) => Source;
+declare const sourceBytes: (bytes: Uint8Array) => Source;
+declare const isSourceUrl: (s: Source) => s is Extract<Source, {
+  kind: "url";
+}>;
+declare const isSourceFile: (s: Source) => s is Extract<Source, {
+  kind: "file";
+}>;
+declare const isSourceString: (s: Source) => s is Extract<Source, {
+  kind: "string";
+}>;
+declare const isSourceBytes: (s: Source) => s is Extract<Source, {
+  kind: "bytes";
+}>;
+declare const isSourcePointer: (s: Source) => s is Extract<Source, {
+  kind: "pointer";
+}>;
+declare const extractPick: (file: string, into: string) => ExtractPick;
+declare const extractScan: (matches: string, into: string, opts?: Omit<ExtractScan, "kind" | "matches" | "into">) => ExtractScan;
+declare const extractDump: (into: string, opts?: Omit<ExtractDump, "kind" | "into">) => ExtractDump;
+declare const emptyRuleset: () => Ruleset;
+declare const allowOsRuleset: (name: OsName) => Ruleset;
+/** Deduplicate by normalized (posix) path; later entries win. */
+declare function deduplicateArtifacts(artifacts: Artifact[]): Artifact[];
+type RawSingle = string | Rule;
+type RawRuleset = RawSingle | RawSingle[];
+declare function parseShortRuleset(raw: RawRuleset): Ruleset;
+declare function parseValset(raw: unknown): Valset;
+//#endregion
+export { Artifact, ConditionalVal, Discovery, ExtractDump, ExtractPick, ExtractRule, ExtractScan, FeatureConstraint, type FetchRetryOptions, HashAlgo, HashEntry, HashRef, Integrity, IntegrityProbes, Launch, Manifest, OPYS_USER_AGENT, OsArch, OsArchSchema, OsConstraint, OsName, OsNameSchema, OsOptions, PointerDescriptor, Rule, RuleAction, RuleSchema, Ruleset, SizeProbes, Source, Val, ValDefs, Valset, allowOsRuleset, decodeManifest, deduplicateArtifacts, emptyRuleset, encodeManifest, extractDump, extractPick, extractScan, fetchWithRetry, filterManifest, globBase, globToRegex, globToRegexSource, interpolate, isSourceBytes, isSourceFile, isSourcePointer, isSourceString, isSourceUrl, parseManifest, parseShortRuleset, parseValset, resolveVars, resolvedArgs, resolvedEnvs, satisfiesRuleset, sourceBytes, sourceFile, sourcePointer, sourceString, sourceUrl };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

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