@shard-for-obsidian/lib 0.2.0

package/dist/client/RegistryClientOptions.d.ts

@@ -0,0 +1,18 @@
+import type { RegistryRepo } from "../types/RegistryTypes.js";
+export interface RegistryClientOptions {
+    name?: string;
+    repo?: RegistryRepo;
+    username?: string;
+    password?: string;
+    token?: string;
+    insecure?: boolean;
+    scheme?: "https" | "http";
+    acceptOCIManifests?: boolean;
+    acceptManifestLists?: boolean;
+    userAgent?: string;
+    scopes?: string[];
+    adapter: {
+        fetch(input: string | Request, init?: RequestInit): Promise<Response>;
+    };
+}
+//# sourceMappingURL=RegistryClientOptions.d.ts.map

package/dist/client/RegistryClientOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryClientOptions.d.ts","sourceRoot":"","sources":["../../src/client/RegistryClientOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QACP,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;KACvE,CAAC;CACH"}

package/dist/client/RegistryClientOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/errors/RegistryErrors.d.ts

@@ -0,0 +1,39 @@
+import type { DockerResponse, RegistryError } from "../types/RegistryTypes.js";
+/** Base class for custom error classes. */
+export declare class ApiError extends Error {
+    constructor(message: string);
+}
+export declare class HttpError extends ApiError {
+    resp: DockerResponse;
+    errors: RegistryError[];
+    name: string;
+    constructor(resp: DockerResponse, errors: RegistryError[], message: string);
+}
+export declare class BadDigestError extends ApiError {
+    readonly name = "BadDigestError";
+}
+export declare class InvalidContentError extends ApiError {
+    readonly name = "InvalidContentError";
+}
+export declare class InternalError extends ApiError {
+    readonly name = "InternalError";
+}
+export declare class ManifestVerificationError extends ApiError {
+    readonly name = "ManifestVerificationError";
+}
+export declare class InvalidManifestError extends ApiError {
+    readonly name = "InvalidManifestError";
+}
+export declare class DownloadError extends ApiError {
+    readonly name = "DownloadError";
+}
+export declare class UploadError extends ApiError {
+    readonly name = "UploadError";
+}
+export declare class BlobReadError extends ApiError {
+    readonly name = "BlobReadError";
+}
+export declare class TooManyRedirectsError extends ApiError {
+    readonly name = "TooManyRedirectsError";
+}
+//# sourceMappingURL=RegistryErrors.d.ts.map

package/dist/errors/RegistryErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryErrors.d.ts","sourceRoot":"","sources":["../../src/errors/RegistryErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/E,2CAA2C;AAC3C,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,SAAU,SAAQ,QAAQ;IAG5B,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,aAAa,EAAE;IAHvB,IAAI,SAAe;gBAEnB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,aAAa,EAAE,EAC9B,OAAO,EAAE,MAAM;CAIlB;AACD,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAkB,IAAI,oBAAoB;CAC3C;AACD,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,SAAkB,IAAI,yBAAyB;CAChD;AAED,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAkB,IAAI,mBAAmB;CAC1C;AAED,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,SAAkB,IAAI,+BAA+B;CACtD;AAED,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,SAAkB,IAAI,0BAA0B;CACjD;AAED,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAkB,IAAI,mBAAmB;CAC1C;AAED,qBAAa,WAAY,SAAQ,QAAQ;IACvC,SAAkB,IAAI,iBAAiB;CACxC;AAED,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAkB,IAAI,mBAAmB;CAC1C;AAOD,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,SAAkB,IAAI,2BAA2B;CAClD"}

package/dist/errors/RegistryErrors.js

@@ -0,0 +1,52 @@
+/*
+ * Error classes that docker-registry-client may produce.
+ */
+/** Base class for custom error classes. */
+export class ApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+        Error.captureStackTrace?.(this, new.target);
+    }
+}
+export class HttpError extends ApiError {
+    resp;
+    errors;
+    name = "HttpError";
+    constructor(resp, errors, message) {
+        super(message);
+        this.resp = resp;
+        this.errors = errors;
+    }
+}
+export class BadDigestError extends ApiError {
+    name = "BadDigestError";
+}
+export class InvalidContentError extends ApiError {
+    name = "InvalidContentError";
+}
+export class InternalError extends ApiError {
+    name = "InternalError";
+}
+export class ManifestVerificationError extends ApiError {
+    name = "ManifestVerificationError";
+}
+export class InvalidManifestError extends ApiError {
+    name = "InvalidManifestError";
+}
+export class DownloadError extends ApiError {
+    name = "DownloadError";
+}
+export class UploadError extends ApiError {
+    name = "UploadError";
+}
+export class BlobReadError extends ApiError {
+    name = "BlobReadError";
+}
+// export class UnauthorizedError extends HttpError {
+//     readonly name = 'UnauthorizedError';
+//     readonly statusCode = 401;
+// }
+export class TooManyRedirectsError extends ApiError {
+    name = "TooManyRedirectsError";
+}

package/dist/ghcr/GhcrConstants.d.ts

@@ -0,0 +1,5 @@
+export declare const REALM = "https://ghcr.io/token";
+export declare const SERVICE = "ghcr.io";
+export declare const SCOPE_REPO_PREFIX = "repository:";
+export declare const SCOPE_PULL_SUFFIX = ":pull";
+//# sourceMappingURL=GhcrConstants.d.ts.map

package/dist/ghcr/GhcrConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GhcrConstants.d.ts","sourceRoot":"","sources":["../../src/ghcr/GhcrConstants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,0BAA0B,CAAC;AAC7C,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,UAAU,CAAC"}

package/dist/ghcr/GhcrConstants.js

@@ -0,0 +1,4 @@
+export const REALM = "https://ghcr.io/token";
+export const SERVICE = "ghcr.io";
+export const SCOPE_REPO_PREFIX = "repository:";
+export const SCOPE_PULL_SUFFIX = ":pull";

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./client/OciRegistryClient.js";
+export * from "./types/ManifestTypes.js";
+export * from "./types/RegistryTypes.js";
+export * from "./types/AuthTypes.js";
+export * from "./types/RequestTypes.js";
+export * from "./parsing/RepoParser.js";
+export * from "./parsing/IndexParser.js";
+export * from "./parsing/LinkHeaderParser.js";
+export * from "./utils/ValidationUtils.js";
+export * from "./utils/DigestUtils.js";
+export * from "./errors/RegistryErrors.js";
+export * from "./ghcr/GhcrConstants.js";
+export type { FetchAdapter } from "./client/FetchAdapter.js";
+export type { RegistryClientOptions } from "./client/RegistryClientOptions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Re-export everything from new structure
+export * from "./client/OciRegistryClient.js";
+export * from "./types/ManifestTypes.js";
+export * from "./types/RegistryTypes.js";
+export * from "./types/AuthTypes.js";
+export * from "./types/RequestTypes.js";
+export * from "./parsing/RepoParser.js";
+export * from "./parsing/IndexParser.js";
+export * from "./parsing/LinkHeaderParser.js";
+export * from "./utils/ValidationUtils.js";
+export * from "./utils/DigestUtils.js";
+export * from "./errors/RegistryErrors.js";
+export * from "./ghcr/GhcrConstants.js";

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["// Re-export everything from new structure\nexport * from \"./client/OciRegistryClient.js\";\nexport * from \"./types/ManifestTypes.js\";\nexport * from \"./types/RegistryTypes.js\";\nexport * from \"./types/AuthTypes.js\";\nexport * from \"./types/RequestTypes.js\";\nexport * from \"./parsing/RepoParser.js\";\nexport * from \"./parsing/IndexParser.js\";\nexport * from \"./parsing/LinkHeaderParser.js\";\nexport * from \"./utils/ValidationUtils.js\";\nexport * from \"./utils/DigestUtils.js\";\nexport * from \"./errors/RegistryErrors.js\";\nexport * from \"./ghcr/GhcrConstants.js\";\nexport type { FetchAdapter } from \"./client/FetchAdapter.js\";\nexport type { RegistryClientOptions } from \"./client/RegistryClientOptions.js\";\n"],
+  "mappings": "AACA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/parsing/IndexParser.d.ts

@@ -0,0 +1,26 @@
+import type { RegistryIndex } from "../types/RegistryTypes.js";
+export declare const DEFAULT_INDEX_NAME = "docker.io";
+export declare const DEFAULT_INDEX_URL = "https://registry-1.docker.io";
+export declare const DEFAULT_LOGIN_SERVERNAME = "https://index.docker.io/v1/";
+/**
+ * Parse a docker index name or index URL.
+ *
+ * Examples:
+ *      docker.io               (no scheme implies 'https')
+ *      index.docker.io         (normalized to docker.io)
+ *      https://docker.io
+ *      http://localhost:5000
+ *      https://index.docker.io/v1/  (special case)
+ *
+ * Special case: `docker` still refers to "https://index.docker.io/v1/"
+ * when dealing with auth (including in its json file).
+ *
+ * @param {String} arg: Optional. Index name (optionally with leading scheme).
+ */
+export declare function parseIndex(arg?: string): RegistryIndex;
+/**
+ * Similar in spirit to docker.git:registry/endpoint.go#NewEndpoint().
+ */
+export declare function urlFromIndex(index: RegistryIndex, scheme?: "http" | "https"): string;
+export declare function isLocalhost(host: string): boolean;
+//# sourceMappingURL=IndexParser.d.ts.map

package/dist/parsing/IndexParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexParser.d.ts","sourceRoot":"","sources":["../../src/parsing/IndexParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK/D,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAEhE,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CAwEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GACxB,MAAM,CAeR;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/parsing/IndexParser.js

@@ -0,0 +1,106 @@
+// --- globals
+// See `INDEXNAME` in docker/docker.git:registry/config.go.
+export const DEFAULT_INDEX_NAME = "docker.io";
+export const DEFAULT_INDEX_URL = "https://registry-1.docker.io";
+export const DEFAULT_LOGIN_SERVERNAME = "https://index.docker.io/v1/";
+/**
+ * Parse a docker index name or index URL.
+ *
+ * Examples:
+ *      docker.io               (no scheme implies 'https')
+ *      index.docker.io         (normalized to docker.io)
+ *      https://docker.io
+ *      http://localhost:5000
+ *      https://index.docker.io/v1/  (special case)
+ *
+ * Special case: `docker` still refers to "https://index.docker.io/v1/"
+ * when dealing with auth (including in its json file).
+ *
+ * @param {String} arg: Optional. Index name (optionally with leading scheme).
+ */
+export function parseIndex(arg) {
+    if (!arg || arg === DEFAULT_LOGIN_SERVERNAME) {
+        // Default index.
+        return {
+            scheme: "https",
+            name: DEFAULT_INDEX_NAME,
+            official: true,
+        };
+    }
+    // Optional protocol/scheme.
+    let indexName;
+    let scheme = "https";
+    const protoSepIdx = arg.indexOf("://");
+    if (protoSepIdx !== -1) {
+        const foundScheme = arg.slice(0, protoSepIdx);
+        if (foundScheme !== "http" && foundScheme !== "https") {
+            throw new Error("invalid index scheme, must be " + '"http" or "https": ' + arg);
+        }
+        scheme = foundScheme;
+        indexName = arg.slice(protoSepIdx + 3);
+    }
+    else {
+        scheme = isLocalhost(arg) ? "http" : "https";
+        indexName = arg;
+    }
+    if (!indexName) {
+        throw new Error("invalid index, empty host: " + arg);
+    }
+    else if (indexName.indexOf(".") === -1 &&
+        indexName.indexOf(":") === -1 &&
+        indexName !== "localhost") {
+        throw new Error(`invalid index, "${indexName}" does not look like a valid host: ${arg}`);
+    }
+    else {
+        // Allow a trailing '/' as from some URL builder functions that
+        // add a default '/' path to a URL, e.g. 'https://docker.io/'.
+        if (indexName[indexName.length - 1] === "/") {
+            indexName = indexName.slice(0, indexName.length - 1);
+        }
+        // Ensure no trailing repo.
+        if (indexName.indexOf("/") !== -1) {
+            throw new Error("invalid index, trailing repo: " + arg);
+        }
+    }
+    // Per docker.git's `ValidateIndexName`.
+    if (indexName === "index." + DEFAULT_INDEX_NAME) {
+        indexName = DEFAULT_INDEX_NAME;
+    }
+    const index = {
+        name: indexName,
+        official: indexName === DEFAULT_INDEX_NAME,
+        scheme,
+    };
+    // Disallow official and 'http'.
+    if (index.official && index.scheme === "http") {
+        throw new Error("invalid index, plaintext HTTP to official index " +
+            "is disallowed: " +
+            arg);
+    }
+    return index;
+}
+/**
+ * Similar in spirit to docker.git:registry/endpoint.go#NewEndpoint().
+ */
+export function urlFromIndex(index, scheme) {
+    if (index.official) {
+        // v1
+        if (scheme != null && scheme !== "https")
+            throw new Error(`Unencrypted communication with docker.io is not allowed`);
+        return DEFAULT_INDEX_URL;
+    }
+    else {
+        if (scheme != null && scheme !== "https" && scheme !== "http")
+            throw new Error(`Non-HTTP communication with docker registries is not allowed`);
+        return `${scheme ?? index.scheme}://${index.name}`;
+    }
+}
+export function isLocalhost(host) {
+    const lead = host.split(":")[0];
+    if (lead === "localhost" || lead === "127.0.0.1" || host.includes("::1")) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}

package/dist/parsing/LinkHeaderParser.d.ts

@@ -0,0 +1,8 @@
+type Link = {
+    rel: string;
+    url: string;
+    params: Record<string, string>;
+};
+export declare function parseLinkHeader(rawHeader: string | null): Link[];
+export {};
+//# sourceMappingURL=LinkHeaderParser.d.ts.map

package/dist/parsing/LinkHeaderParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkHeaderParser.d.ts","sourceRoot":"","sources":["../../src/parsing/LinkHeaderParser.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,GAAG;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAGF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,CA+BhE"}

package/dist/parsing/LinkHeaderParser.js

@@ -0,0 +1,34 @@
+const linkRegex = /^<([^>]+)>(?:\s*;\s*(.+))?$/;
+export function parseLinkHeader(rawHeader) {
+    if (!rawHeader)
+        return [];
+    return rawHeader
+        .split(",")
+        .slice(0, 5) // Arbitrary limit to how many links we are willing to parse
+        .flatMap((piece) => {
+        const matches = piece.trim().match(linkRegex);
+        if (!matches)
+            return [];
+        const { rel, ...params } = matches[2]
+            ?.split(";")
+            .map((param) => param.trim().split("="))
+            .reduce((acc, [key, value]) => {
+            if (!value)
+                return acc;
+            if (value.startsWith('"') && value.endsWith('"')) {
+                value = value.slice(1, -1);
+            }
+            acc[key] = value;
+            return acc;
+        }, {}) ?? {};
+        if (!rel)
+            return [];
+        return [
+            {
+                rel,
+                url: matches[1],
+                params,
+            },
+        ];
+    });
+}

package/dist/parsing/RepoParser.d.ts

@@ -0,0 +1,54 @@
+import type { RegistryImage, RegistryIndex, RegistryRepo } from "../types/RegistryTypes.js";
+export declare const DEFAULT_TAG = "latest";
+/**
+ * Parse a docker repo and tag string: [INDEX/]REPO[:TAG|@DIGEST]
+ *
+ * Examples:
+ *    busybox
+ *    google/python
+ *    docker.io/ubuntu
+ *    localhost:5000/blarg
+ *    http://localhost:5000/blarg
+ *
+ * Dev Notes:
+ * - This is meant to mimic
+ *   docker.git:registry/config.go#ServiceConfig.NewRepositoryInfo
+ *   as much as reasonable -- with the addition that we maintain the
+ *   'tag' field.  Also, that we accept the scheme on the "INDEX" is
+ *   different than docker.git's parsing.
+ * - TODO: what about the '@digest' digest alternative to a tag? See:
+ *   // JSSTYLED
+ *   https://github.com/docker/docker/blob/0c7b51089c8cd7ef3510a9b40edaa139a7ca91aa/pkg/parsers/parsers.go#L68
+ *
+ * @param arg {String} The docker repo string to parse. See examples above.
+ * @param defaultIndex {Object|String} Optional. The default index to use
+ *      if not specified with `arg`. If not given the default is 'docker.io'.
+ *      If given it may either be a string, e.g. 'https://myreg.example.com',
+ *      or parsed index object, as from `parseIndex()`.
+ */
+export declare function parseRepo(arg: string, defaultIndex?: string | RegistryIndex): RegistryRepo;
+/**
+ * Parse a docker repo and tag/digest string: [INDEX/]REPO[:TAG|@DIGEST|:TAG@DIGEST]
+ *
+ * Examples:
+ *    busybox
+ *    busybox:latest
+ *    google/python:3.3
+ *    docker.io/ubuntu
+ *    localhost:5000/blarg
+ *    http://localhost:5000/blarg:latest
+ *    google/python:3.3@sha256:fb9f16730ac6316afa4d97caa51302199...
+ *    alpine@sha256:fb9f16730ac6316afa4d97caa5130219927bfcecf0b0...
+ *
+ * Dev Notes:
+ * - TODO Validation on digest and tag would be nice.
+ *
+ * @param arg {String} The docker repo:tag string to parse. See examples above.
+ * @param defaultIndex {Object|String} Optional. The default index to use
+ *      if not specified with `arg`. If not given the default is 'docker.io'.
+ *      If given it may either be a string, e.g. 'https://myreg.example.com',
+ *      or parsed index object, as from `parseIndex()`.
+ */
+export declare function parseRepoAndRef(arg: string, defaultIndex?: string | RegistryIndex): RegistryImage;
+export declare const parseRepoAndTag: typeof parseRepoAndRef;
+//# sourceMappingURL=RepoParser.d.ts.map

package/dist/parsing/RepoParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepoParser.d.ts","sourceRoot":"","sources":["../../src/parsing/RepoParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACb,MAAM,2BAA2B,CAAC;AAMnC,eAAO,MAAM,WAAW,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GACpC,YAAY,CAkHd;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GACpC,aAAa,CAgCf;AAED,eAAO,MAAM,eAAe,wBAAkB,CAAC"}

package/dist/parsing/RepoParser.js

@@ -0,0 +1,186 @@
+import { parseIndex } from "./IndexParser.js";
+import { splitIntoTwo } from "../utils/ValidationUtils.js";
+// JSSTYLED
+// 'DEFAULTTAG' from https://github.com/docker/docker/blob/0c7b51089c8cd7ef3510a9b40edaa139a7ca91aa/graph/tags.go#L25
+export const DEFAULT_TAG = "latest";
+const VALID_NS = /^[a-z0-9._-]*$/;
+const VALID_REPO = /^[a-z0-9_/.-]*$/;
+/**
+ * Parse a docker repo and tag string: [INDEX/]REPO[:TAG|@DIGEST]
+ *
+ * Examples:
+ *    busybox
+ *    google/python
+ *    docker.io/ubuntu
+ *    localhost:5000/blarg
+ *    http://localhost:5000/blarg
+ *
+ * Dev Notes:
+ * - This is meant to mimic
+ *   docker.git:registry/config.go#ServiceConfig.NewRepositoryInfo
+ *   as much as reasonable -- with the addition that we maintain the
+ *   'tag' field.  Also, that we accept the scheme on the "INDEX" is
+ *   different than docker.git's parsing.
+ * - TODO: what about the '@digest' digest alternative to a tag? See:
+ *   // JSSTYLED
+ *   https://github.com/docker/docker/blob/0c7b51089c8cd7ef3510a9b40edaa139a7ca91aa/pkg/parsers/parsers.go#L68
+ *
+ * @param arg {String} The docker repo string to parse. See examples above.
+ * @param defaultIndex {Object|String} Optional. The default index to use
+ *      if not specified with `arg`. If not given the default is 'docker.io'.
+ *      If given it may either be a string, e.g. 'https://myreg.example.com',
+ *      or parsed index object, as from `parseIndex()`.
+ */
+export function parseRepo(arg, defaultIndex) {
+    let index;
+    // Strip off optional leading `INDEX/`, parse it to `info.index` and
+    // leave the rest in `remoteName`.
+    let remoteNameRaw;
+    const protoSepIdx = arg.indexOf("://");
+    if (protoSepIdx !== -1) {
+        // (A) repo with a protocol, e.g. 'https://host/repo'.
+        const slashIdx = arg.indexOf("/", protoSepIdx + 3);
+        if (slashIdx === -1) {
+            throw new Error('invalid repository name, no "/REPO" after ' + "hostame: " + arg);
+        }
+        const indexName = arg.slice(0, slashIdx);
+        remoteNameRaw = arg.slice(slashIdx + 1);
+        index = parseIndex(indexName);
+    }
+    else {
+        const parts = splitIntoTwo(arg, "/");
+        if (parts.length === 1 ||
+            /* or if parts[0] doesn't look like a hostname or IP */
+            (parts[0].indexOf(".") === -1 &&
+                parts[0].indexOf(":") === -1 &&
+                parts[0] !== "localhost")) {
+            // (B) repo without leading 'INDEX/'.
+            if (defaultIndex === undefined) {
+                index = parseIndex();
+            }
+            else if (typeof defaultIndex === "string") {
+                index = parseIndex(defaultIndex);
+            }
+            else {
+                index = defaultIndex;
+            }
+            remoteNameRaw = arg;
+        }
+        else {
+            // (C) repo with leading 'INDEX/' (without protocol).
+            index = parseIndex(parts[0]);
+            remoteNameRaw = parts[1];
+        }
+    }
+    // Validate remoteName (docker `validateRemoteName`).
+    const nameParts = splitIntoTwo(remoteNameRaw, "/");
+    let ns = "", name;
+    if (nameParts.length === 2) {
+        name = nameParts[1];
+        // Validate ns.
+        ns = nameParts[0];
+        if (ns.length < 2 || ns.length > 255) {
+            throw new Error("invalid repository namespace, must be between " +
+                "2 and 255 characters: " +
+                ns);
+        }
+        if (!VALID_NS.test(ns)) {
+            throw new Error("invalid repository namespace, may only contain " +
+                "[a-z0-9._-] characters: " +
+                ns);
+        }
+        if (ns[0] === "-" && ns[ns.length - 1] === "-") {
+            throw new Error("invalid repository namespace, cannot start or " +
+                "end with a hypen: " +
+                ns);
+        }
+        if (ns.indexOf("--") !== -1) {
+            throw new Error("invalid repository namespace, cannot contain " +
+                "consecutive hyphens: " +
+                ns);
+        }
+    }
+    else {
+        name = remoteNameRaw;
+        if (index.official) {
+            ns = "library";
+        }
+    }
+    // Validate name.
+    if (!VALID_REPO.test(name)) {
+        throw new Error("invalid repository name, may only contain " +
+            "[a-z0-9_/.-] characters: " +
+            name);
+    }
+    const isLibrary = index.official && ns === "library";
+    const remoteName = ns ? `${ns}/${name}` : name;
+    const localName = index.official
+        ? isLibrary
+            ? name
+            : remoteName
+        : `${index.name}/${remoteName}`;
+    const canonicalName = index.official
+        ? `${parseIndex().name}/${localName}`
+        : localName;
+    return {
+        index,
+        official: isLibrary,
+        remoteName,
+        localName,
+        canonicalName,
+    };
+}
+/**
+ * Parse a docker repo and tag/digest string: [INDEX/]REPO[:TAG|@DIGEST|:TAG@DIGEST]
+ *
+ * Examples:
+ *    busybox
+ *    busybox:latest
+ *    google/python:3.3
+ *    docker.io/ubuntu
+ *    localhost:5000/blarg
+ *    http://localhost:5000/blarg:latest
+ *    google/python:3.3@sha256:fb9f16730ac6316afa4d97caa51302199...
+ *    alpine@sha256:fb9f16730ac6316afa4d97caa5130219927bfcecf0b0...
+ *
+ * Dev Notes:
+ * - TODO Validation on digest and tag would be nice.
+ *
+ * @param arg {String} The docker repo:tag string to parse. See examples above.
+ * @param defaultIndex {Object|String} Optional. The default index to use
+ *      if not specified with `arg`. If not given the default is 'docker.io'.
+ *      If given it may either be a string, e.g. 'https://myreg.example.com',
+ *      or parsed index object, as from `parseIndex()`.
+ */
+export function parseRepoAndRef(arg, defaultIndex) {
+    // Parse off the tag/digest per
+    // https://github.com/docker/docker/blob/0c7b51089c8cd7ef3510a9b40edaa139a7ca91aa/pkg/parsers/parsers.go#L69
+    let digest = null;
+    let tag = null;
+    const atIdx = arg.lastIndexOf("@");
+    if (atIdx !== -1) {
+        digest = arg.slice(atIdx + 1);
+        arg = arg.slice(0, atIdx);
+    }
+    else {
+        tag = DEFAULT_TAG;
+    }
+    const colonIdx = arg.lastIndexOf(":");
+    const slashIdx = arg.lastIndexOf("/");
+    if (colonIdx !== -1 && colonIdx > slashIdx) {
+        tag = arg.slice(colonIdx + 1);
+        arg = arg.slice(0, colonIdx);
+    }
+    const repo = parseRepo(arg, defaultIndex);
+    return {
+        ...repo,
+        digest,
+        tag,
+        canonicalRef: [
+            repo.canonicalName,
+            tag ? `:${tag}` : "",
+            digest ? `@${digest}` : "",
+        ].join(""),
+    };
+}
+export const parseRepoAndTag = parseRepoAndRef;

package/dist/types/AuthTypes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Authentication types for registry operations
+ */
+export type AuthInfo = {
+    type: "None";
+} | {
+    type: "Basic";
+    username: string;
+    password: string;
+} | {
+    type: "Bearer";
+    token: string;
+};
+//# sourceMappingURL=AuthTypes.d.ts.map

package/dist/types/AuthTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthTypes.d.ts","sourceRoot":"","sources":["../../src/types/AuthTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/AuthTypes.js

@@ -0,0 +1,4 @@
+/**
+ * Authentication types for registry operations
+ */
+export {};