@agentxm/client-core 0.1.6

package/dist/src/unstable/packaging/docker.js

@@ -0,0 +1,282 @@
+/**
+ * Docker image detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const dockerType = Schema.decodeUnknownSync(PackageTypeSchema)("docker");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Parse a Docker image reference into namespace, name, and version components.
+ *
+ * Image references can be:
+ * - `name` (e.g. `nginx`)
+ * - `name:tag` (e.g. `nginx:alpine`)
+ * - `org/name:tag` (e.g. `library/nginx:1.25`)
+ * - `registry/org/name:tag` (e.g. `ghcr.io/org/myapp:latest`)
+ */
+const parseImageRef = (ref) => {
+    const trimmed = ref.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    // Split on : to get name part and tag part
+    const colonIdx = trimmed.lastIndexOf(":");
+    let namePart;
+    let tag;
+    if (colonIdx > 0 && !trimmed.slice(colonIdx).includes("/")) {
+        namePart = trimmed.slice(0, colonIdx);
+        tag = trimmed.slice(colonIdx + 1);
+    }
+    else {
+        namePart = trimmed;
+        tag = undefined;
+    }
+    // Remove @sha256 digest if present
+    const digestIdx = namePart.indexOf("@");
+    if (digestIdx > 0) {
+        namePart = namePart.slice(0, digestIdx);
+    }
+    // Split namespace and name
+    const lastSlash = namePart.lastIndexOf("/");
+    let namespace;
+    let name;
+    if (lastSlash > 0) {
+        namespace = namePart.slice(0, lastSlash);
+        name = namePart.slice(lastSlash + 1);
+    }
+    else {
+        namespace = undefined;
+        name = namePart;
+    }
+    if (name.length === 0)
+        return undefined;
+    // `latest` tag or no tag → versionless
+    const version = tag !== undefined && tag !== "latest" && tag.length > 0 ? tag : undefined;
+    return { namespace, name, version };
+};
+/**
+ * Convert a parsed image reference to a DetectedPackage.
+ */
+const imageToPurl = (ref, source) => {
+    const parsed = parseImageRef(ref);
+    if (parsed === undefined)
+        return undefined;
+    const purl = new PackageURL("docker", parsed.namespace ?? null, parsed.name, parsed.version ?? null, null, null);
+    const purlParts = decodePurl(purl.toString());
+    return { purl: purlParts, type: dockerType, source };
+};
+/**
+ * Parse ARG directives from Dockerfile content.
+ * Returns a map of variable name to default value (or undefined if no default).
+ */
+const parseDockerArgs = (content) => {
+    const args = new Map();
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.toUpperCase().startsWith("ARG "))
+            continue;
+        const rest = trimmed.slice(4).trim();
+        const eqIdx = rest.indexOf("=");
+        if (eqIdx > 0) {
+            const name = rest.slice(0, eqIdx).trim();
+            const value = rest.slice(eqIdx + 1).trim();
+            args.set(name, value);
+        }
+        else {
+            args.set(rest, undefined);
+        }
+    }
+    return args;
+};
+/**
+ * Resolve a variable reference like `${VARIABLE}` using ARG defaults.
+ * Returns the resolved string, or undefined if unresolvable.
+ */
+const resolveVariable = (imageRef, args) => {
+    // Check if the entire reference or parts contain variables
+    const varPattern = /\$\{([^}]+)\}/g;
+    let resolved = imageRef;
+    let match = varPattern.exec(imageRef);
+    while (match !== null) {
+        const varName = match[1];
+        if (varName === undefined)
+            return undefined;
+        // Check for ${VAR:-default} syntax
+        const colonIdx = varName.indexOf(":-");
+        const defaultValue = colonIdx > 0 ? varName.slice(colonIdx + 2) : args.get(varName);
+        if (defaultValue === undefined)
+            return undefined;
+        resolved = resolved.replace(match[0], defaultValue);
+        match = varPattern.exec(imageRef);
+    }
+    return resolved;
+};
+/**
+ * Parse FROM directives from Dockerfile content.
+ */
+const parseDockerfile = (content, source) => {
+    const args = parseDockerArgs(content);
+    const lines = content.split("\n");
+    const results = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.toUpperCase().startsWith("FROM "))
+            continue;
+        const rest = trimmed.slice(5).trim();
+        // Remove AS alias
+        const parts = rest.split(/\s+/);
+        let imageRef = parts[0];
+        if (imageRef === undefined || imageRef.length === 0)
+            continue;
+        // Resolve variables
+        if (imageRef.includes("${")) {
+            const resolved = resolveVariable(imageRef, args);
+            if (resolved === undefined)
+                continue;
+            imageRef = resolved;
+        }
+        // Skip scratch
+        if (imageRef === "scratch")
+            continue;
+        const detected = imageToPurl(imageRef, source);
+        if (detected !== undefined)
+            results.push(detected);
+    }
+    return results;
+};
+/**
+ * Parse docker-compose YAML using line-based parsing.
+ * Extracts `image:` values from service definitions.
+ */
+const parseDockerCompose = (content, source) => {
+    const lines = content.split("\n");
+    const results = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("#"))
+            continue;
+        // Match `image: value` lines
+        if (trimmed.startsWith("image:")) {
+            const value = trimmed.slice(6).trim();
+            // Remove quotes if present
+            const cleaned = value.replace(/^["']|["']$/g, "");
+            if (cleaned.length > 0) {
+                const detected = imageToPurl(cleaned, source);
+                if (detected !== undefined)
+                    results.push(detected);
+            }
+        }
+    }
+    return results;
+};
+/**
+ * Docker package detector.
+ *
+ * Scans `Dockerfile`, `docker-compose.yml`, and `docker-compose.yaml`
+ * for image dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const dockerDetector = {
+    type: dockerType,
+    detect: Effect.fn("detect.docker")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const results = [];
+        // Parse Dockerfile
+        const dockerfilePath = path.join(projectDir, "Dockerfile");
+        const dockerfileContent = yield* readFileOptional(dockerfilePath);
+        if (Option.isSome(dockerfileContent)) {
+            const deps = parseDockerfile(dockerfileContent.value, dockerfilePath);
+            results.push(...deps);
+        }
+        // Parse docker-compose.yml
+        const composeYmlPath = path.join(projectDir, "docker-compose.yml");
+        const composeYmlContent = yield* readFileOptional(composeYmlPath);
+        if (Option.isSome(composeYmlContent)) {
+            const deps = parseDockerCompose(composeYmlContent.value, composeYmlPath);
+            results.push(...deps);
+        }
+        // Parse docker-compose.yaml
+        const composeYamlPath = path.join(projectDir, "docker-compose.yaml");
+        const composeYamlContent = yield* readFileOptional(composeYamlPath);
+        if (Option.isSome(composeYamlContent)) {
+            const deps = parseDockerCompose(composeYamlContent.value, composeYamlPath);
+            results.push(...deps);
+        }
+        return results;
+    }, Effect.annotateLogs({ detector: "docker" }), Effect.withSpan("detect.docker")),
+};
+/**
+ * Docker package reader.
+ *
+ * Inspects local Docker image metadata for `sh.axm.recommended-extensions`
+ * annotation. Since inspecting Docker images requires the Docker CLI,
+ * this reader returns Option.none when Docker is not available.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const dockerReader = {
+    type: dockerType,
+    read: Effect.fn("read.docker")(function* (pkg) {
+        const path = yield* Path.Path;
+        // Reconstruct the image name from purl parts
+        const imageName = pkg.purl.namespace
+            ? `${pkg.purl.namespace}/${pkg.purl.name}`
+            : pkg.purl.name;
+        const imageRef = pkg.purl.version ? `${imageName}:${pkg.purl.version}` : imageName;
+        // Derive project directory from source
+        const projectDir = path.dirname(pkg.source);
+        // Check for a local .axm-docker-annotations/<image>.json file
+        // This is a simplified approach that checks for sidecar annotation files
+        const safeImageName = imageRef.replace(/[/:]/g, "_");
+        const annotationPath = path.join(projectDir, ".axm-docker-annotations", `${safeImageName}.json`);
+        const content = yield* readFileOptional(annotationPath);
+        if (Option.isNone(content))
+            return Option.none();
+        const parsed = yield* parseJsonOptional(content.value, `docker annotations for ${imageRef}`);
+        if (Option.isNone(parsed))
+            return Option.none();
+        // Validate axm metadata structure
+        const metaResult = decodeAxmMeta(parsed.value);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in docker image ${imageRef}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "docker" }), Effect.withSpan("read.docker")),
+};
+//# sourceMappingURL=docker.js.map

package/dist/src/unstable/packaging/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/docker.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/packaging/gem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ruby gem package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * Gem package detector.
+ *
+ * Scans `Gemfile` and `*.gemspec` files in the project directory and extracts
+ * gem dependencies. Deduplicates gems that appear in both sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const gemDetector: PackageDetector;
+/**
+ * Gem package reader.
+ *
+ * Reads gemspec metadata from `<gem-dir>/specifications/<gem>.gemspec`
+ * and extracts `axm_`-prefixed metadata keys.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const gemReader: PackageReader;
+//# sourceMappingURL=gem.d.ts.map

package/dist/src/unstable/packaging/gem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gem.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/gem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqHlF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAgDzB,CAAC;AAgCF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,aA8DvB,CAAC"}

package/dist/src/unstable/packaging/gem.js

@@ -0,0 +1,248 @@
+/**
+ * Ruby gem package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { envWithDefault } from "../utils/environment.js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const gemType = Schema.decodeUnknownSync(PackageTypeSchema)("gem");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/** Range operators that indicate non-exact version constraints. */
+const RANGE_OPERATORS = ["~>", ">=", "<=", ">", "<", "!="];
+/**
+ * Returns true if the version specifier is an exact version (no range operators).
+ * Exact versions are bare numeric strings like "5.6.7".
+ */
+const isExactVersion = (specifier) => {
+    const trimmed = specifier.trim();
+    if (RANGE_OPERATORS.some((op) => trimmed.startsWith(op)))
+        return false;
+    return /^\d+(\.\d+)*$/.test(trimmed);
+};
+/**
+ * Regex to match `gem 'name'` or `gem "name"` directives in a Gemfile.
+ * Captures: gem name, optional version string, optional options.
+ */
+const GEMFILE_GEM_RE = /^\s*gem\s+['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]*)['"]\s*)?(?:,\s*(.*))?$/;
+/** Patterns for path/git/github options that indicate non-registry sources. */
+const SKIP_OPTIONS_RE = /\b(?:path|git|github)\s*:/;
+/**
+ * Parse a Gemfile line into a gem name and optional version, or undefined if skipped.
+ */
+const parseGemfileLine = (line, source) => {
+    const match = GEMFILE_GEM_RE.exec(line);
+    if (match === null)
+        return undefined;
+    const name = match[1];
+    const versionStr = match[2];
+    const options = match[3];
+    if (name === undefined)
+        return undefined;
+    // Check for path/git/github options - skip non-registry sources
+    if (options !== undefined && SKIP_OPTIONS_RE.test(options))
+        return undefined;
+    // Also check the full line for options that might come after the version
+    const afterName = line.slice(line.indexOf(name) + name.length);
+    if (SKIP_OPTIONS_RE.test(afterName))
+        return undefined;
+    const version = versionStr !== undefined && isExactVersion(versionStr) ? versionStr : undefined;
+    const purl = new PackageURL("gem", null, name, version ?? null, null, null);
+    const purlParts = decodePurl(purl.toString());
+    return { purl: purlParts, type: gemType, source };
+};
+/**
+ * Parse Gemfile content and extract gem dependencies.
+ */
+const parseGemfile = (content, source) => {
+    const lines = content.split("\n");
+    const results = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        const detected = parseGemfileLine(trimmed, source);
+        if (detected !== undefined)
+            results.push(detected);
+    }
+    return results;
+};
+/**
+ * Regex to match add_dependency, add_runtime_dependency, add_development_dependency
+ * in gemspec files.
+ */
+const GEMSPEC_DEP_RE = /\.\s*add_(?:runtime_|development_)?dependency\s*\(?\s*['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]*)['"]\s*)?/;
+/**
+ * Parse a gemspec file and extract dependency declarations.
+ */
+const parseGemspec = (content, source) => {
+    const lines = content.split("\n");
+    const results = [];
+    for (const line of lines) {
+        const match = GEMSPEC_DEP_RE.exec(line);
+        if (match === null)
+            continue;
+        const name = match[1];
+        if (name === undefined)
+            continue;
+        const versionStr = match[2];
+        const version = versionStr !== undefined && isExactVersion(versionStr) ? versionStr : undefined;
+        const purl = new PackageURL("gem", null, name, version ?? null, null, null);
+        const purlParts = decodePurl(purl.toString());
+        results.push({ purl: purlParts, type: gemType, source });
+    }
+    return results;
+};
+/**
+ * Gem package detector.
+ *
+ * Scans `Gemfile` and `*.gemspec` files in the project directory and extracts
+ * gem dependencies. Deduplicates gems that appear in both sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const gemDetector = {
+    type: gemType,
+    detect: Effect.fn("detect.gem")(function* (projectDir) {
+        const fs = yield* FileSystem.FileSystem;
+        const path = yield* Path.Path;
+        const results = [];
+        const seen = new Set();
+        const addUnique = (deps) => {
+            for (const dep of deps) {
+                const key = dep.purl.name;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    results.push(dep);
+                }
+            }
+        };
+        // Parse Gemfile
+        const gemfilePath = path.join(projectDir, "Gemfile");
+        const gemfileContent = yield* readFileOptional(gemfilePath);
+        if (Option.isSome(gemfileContent)) {
+            const deps = parseGemfile(gemfileContent.value, gemfilePath);
+            addUnique(deps);
+        }
+        // Parse *.gemspec files
+        const dirEntries = yield* fs.readDirectory(projectDir).pipe(Effect.option);
+        if (Option.isSome(dirEntries)) {
+            for (const entry of dirEntries.value) {
+                if (entry.endsWith(".gemspec")) {
+                    const gemspecPath = path.join(projectDir, entry);
+                    const gemspecContent = yield* readFileOptional(gemspecPath);
+                    if (Option.isSome(gemspecContent)) {
+                        const deps = parseGemspec(gemspecContent.value, gemspecPath);
+                        addUnique(deps);
+                    }
+                }
+            }
+        }
+        return results;
+    }, Effect.annotateLogs({ detector: "gem" }), Effect.withSpan("detect.gem")),
+};
+/**
+ * Resolve the GEM_HOME or default gem installation directory.
+ * Uses GEM_HOME env var, falling back to the default Ruby gems directory.
+ */
+const resolveGemDir = () => envWithDefault("GEM_HOME", `${os.homedir()}/.gem/ruby`);
+/**
+ * Parse the `axm_recommended_extensions` value from a gemspec metadata string.
+ * The value format is: `"axm_recommended_extensions" => "[@scope/skills/name@^1.0.0]"`
+ */
+const parseAxmMetadataFromGemspec = (content) => {
+    // Look for axm_recommended_extensions in the metadata hash
+    const match = /"axm_recommended_extensions"\s*=>\s*"([^"]*)"/.exec(content);
+    if (match === null || match[1] === undefined)
+        return undefined;
+    const value = match[1];
+    // Parse the array-like value: [item1, item2]
+    if (!value.startsWith("[") || !value.endsWith("]"))
+        return undefined;
+    const inner = value.slice(1, -1).trim();
+    if (inner === "")
+        return { recommendedExtensions: [] };
+    const items = inner
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    return { recommendedExtensions: items };
+};
+/**
+ * Gem package reader.
+ *
+ * Reads gemspec metadata from `<gem-dir>/specifications/<gem>.gemspec`
+ * and extracts `axm_`-prefixed metadata keys.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const gemReader = {
+    type: gemType,
+    read: Effect.fn("read.gem")(function* (pkg) {
+        const fs = yield* FileSystem.FileSystem;
+        const path = yield* Path.Path;
+        const gemDir = yield* resolveGemDir();
+        const gemName = pkg.purl.name;
+        const version = pkg.purl.version;
+        // Try to find the gemspec in the specifications directory.
+        // Gemspec filename format: <name>-<version>.gemspec
+        const specsDir = path.join(gemDir, "specifications");
+        // If no version, try to find any matching gemspec
+        if (version !== undefined) {
+            const gemspecPath = path.join(specsDir, `${gemName}-${version}.gemspec`);
+            const content = yield* readFileOptional(gemspecPath);
+            if (Option.isNone(content))
+                return Option.none();
+            const axmMeta = parseAxmMetadataFromGemspec(content.value);
+            if (axmMeta === undefined)
+                return Option.none();
+            const metaResult = decodeAxmMeta(axmMeta);
+            if (Result.isFailure(metaResult)) {
+                yield* Effect.logWarning(`Invalid axm metadata in ${gemName}-${version}: schema validation failed`);
+                return Option.none();
+            }
+            return Option.some(metaResult.success.recommendedExtensions);
+        }
+        // No version - scan specs directory for matching gemspec
+        const dirEntries = yield* fs.readDirectory(specsDir).pipe(Effect.option);
+        if (Option.isNone(dirEntries))
+            return Option.none();
+        const matchingSpec = dirEntries.value.find((entry) => entry.startsWith(`${gemName}-`) && entry.endsWith(".gemspec"));
+        if (matchingSpec === undefined)
+            return Option.none();
+        const gemspecPath = path.join(specsDir, matchingSpec);
+        const content = yield* readFileOptional(gemspecPath);
+        if (Option.isNone(content))
+            return Option.none();
+        const axmMeta = parseAxmMetadataFromGemspec(content.value);
+        if (axmMeta === undefined)
+            return Option.none();
+        const metaResult = decodeAxmMeta(axmMeta);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in ${gemName}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "gem" }), Effect.withSpan("read.gem")),
+};
+//# sourceMappingURL=gem.js.map

package/dist/src/unstable/packaging/gem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gem.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/gem.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/packaging/golang.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Go module package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * Go module package detector.
+ *
+ * Scans `go.mod` in the project directory and extracts direct dependencies
+ * from `require` directives, filtering out `// indirect` entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const golangDetector: PackageDetector;
+/**
+ * Go module package reader.
+ *
+ * Reads `axm.json` from `$GOPATH/pkg/mod/<module>@<version>/` for each
+ * detected Go module and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const golangReader: PackageReader;
+//# sourceMappingURL=golang.d.ts.map

package/dist/src/unstable/packaging/golang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golang.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/golang.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0IlF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,eAwB5B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,aAoC1B,CAAC"}