@arcforges/api-client 1.0.0-ci.101.1

package/dist/shapes/gen/PackageInventory.js

@@ -0,0 +1,327 @@
+export function isPackageInventory(value) { return check0(value); }
+/** The schema's declared UTF-8 document bound in bytes. */
+export const packageInventoryJsonMaxBytes = 4194304;
+/** Parses one strict PackageInventory document; refusal kinds match the C# codec. */
+export function tryParsePackageInventoryJson(input) {
+    const parsed = strictJson(input, 4194304);
+    if (!parsed.ok)
+        return parsed;
+    return isPackageInventory(parsed.value) ? { ok: true, value: parsed.value } : { ok: false, failure: "invalid" };
+}
+/** Parses one strict PackageInventory document or throws an error carrying the refusal kind. */
+export function parsePackageInventoryJson(input) {
+    const result = tryParsePackageInventoryJson(input);
+    if (!result.ok)
+        throw Object.assign(new Error(`PackageInventory JSON refused: ${result.failure}.`), { failure: result.failure });
+    return result.value;
+}
+/** Writes compact UTF-8 in schema property order and refuses output the schema rejects. */
+export function serializePackageInventoryJson(value) {
+    const bytes = new TextEncoder().encode(JSON.stringify(orderPackageInventory(value)));
+    const result = tryParsePackageInventoryJson(bytes);
+    if (!result.ok)
+        throw Object.assign(new Error(`PackageInventory JSON refused: ${result.failure}.`), { failure: result.failure });
+    return bytes;
+}
+function orderInventoryFile(value) {
+    const out = {};
+    out["path"] = value["path"];
+    out["size"] = value["size"];
+    out["sha256"] = value["sha256"];
+    return out;
+}
+function orderPackageInventory(value) {
+    const out = {};
+    out["schemaVersion"] = value["schemaVersion"];
+    out["files"] = value["files"].map(item => orderInventoryFile(item));
+    return out;
+}
+function check0(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "schemaVersion":
+                if (!check1(object[key]))
+                    return false;
+                break;
+            case "files":
+                if (!check2(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "schemaVersion"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "files"))
+        return false;
+    if (!inventoryRules(value))
+        return false;
+    if (!inventoryRules(value))
+        return false;
+    return true;
+}
+function check1(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if (value !== "inventory.v1")
+        return false;
+    return true;
+}
+function check2(value) {
+    if (!Array.isArray(value))
+        return false;
+    if (value.length < 1)
+        return false;
+    if (value.length > 10000)
+        return false;
+    if (!value.every(item => check3(item)))
+        return false;
+    return true;
+}
+function check3(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "path":
+                if (!check4(object[key]))
+                    return false;
+                break;
+            case "size":
+                if (!check5(object[key]))
+                    return false;
+                break;
+            case "sha256":
+                if (!check6(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "path"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "size"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "sha256"))
+        return false;
+    return true;
+}
+function check4(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)*$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+function check5(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ([...value].length > 20)
+        return false;
+    if ((new RegExp("^(0|[1-9][0-9]*)$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    if (BigInt(value) > 18446744073709551615n)
+        return false;
+    return true;
+}
+function check6(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[0-9a-f]{64}$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+/** Strict UTF-8 JSON: no BOM, comments, trailing commas or duplicate properties; depth <= 32; integer lexemes only. */
+function strictJson(input, maxBytes) {
+    let text;
+    if (typeof input === "string") {
+        if (!validText(input))
+            return { ok: false, failure: "malformed" };
+        if (new TextEncoder().encode(input).byteLength > maxBytes)
+            return { ok: false, failure: "tooLarge" };
+        text = input;
+    }
+    else {
+        if (input.byteLength > maxBytes)
+            return { ok: false, failure: "tooLarge" };
+        try {
+            text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(input);
+        }
+        catch {
+            return { ok: false, failure: "malformed" };
+        }
+    }
+    try {
+        return { ok: true, value: new StrictJsonReader(text).document() };
+    }
+    catch {
+        return { ok: false, failure: "malformed" };
+    }
+}
+class StrictJsonReader {
+    text;
+    index = 0;
+    constructor(text) {
+        this.text = text;
+    }
+    document() {
+        this.space();
+        const value = this.value(0);
+        this.space();
+        if (this.index !== this.text.length)
+            throw new SyntaxError("Trailing JSON content");
+        return value;
+    }
+    value(depth) {
+        switch (this.text[this.index]) {
+            case "{": return this.object(depth + 1);
+            case "[": return this.array(depth + 1);
+            case '"': return this.string();
+            case "t": return this.literal("true", true);
+            case "f": return this.literal("false", false);
+            case "n": return this.literal("null", null);
+            default: return this.number();
+        }
+    }
+    object(depth) {
+        if (depth > 32)
+            throw new SyntaxError("JSON depth exceeded");
+        this.index++;
+        const out = {};
+        const keys = new Set();
+        this.space();
+        if (this.text[this.index] === "}") {
+            this.index++;
+            return out;
+        }
+        for (;;) {
+            this.space();
+            if (this.text[this.index] !== '"')
+                throw new SyntaxError("Expected property name");
+            const key = this.string();
+            if (keys.has(key))
+                throw new SyntaxError("Duplicate JSON property");
+            keys.add(key);
+            this.space();
+            if (this.text[this.index++] !== ":")
+                throw new SyntaxError("Expected colon");
+            this.space();
+            // defineProperty keeps names such as __proto__ as ordinary own properties.
+            Object.defineProperty(out, key, { value: this.value(depth), enumerable: true, writable: true, configurable: true });
+            this.space();
+            const next = this.text[this.index++];
+            if (next === "}")
+                return out;
+            if (next !== ",")
+                throw new SyntaxError("Expected comma");
+        }
+    }
+    array(depth) {
+        if (depth > 32)
+            throw new SyntaxError("JSON depth exceeded");
+        this.index++;
+        const out = [];
+        this.space();
+        if (this.text[this.index] === "]") {
+            this.index++;
+            return out;
+        }
+        for (;;) {
+            this.space();
+            out.push(this.value(depth));
+            this.space();
+            const next = this.text[this.index++];
+            if (next === "]")
+                return out;
+            if (next !== ",")
+                throw new SyntaxError("Expected comma");
+        }
+    }
+    string() {
+        this.index++;
+        let out = "";
+        for (;;) {
+            const c = this.text[this.index++];
+            if (c === undefined)
+                throw new SyntaxError("Unterminated string");
+            if (c === '"')
+                break;
+            if (c < " ")
+                throw new SyntaxError("Unescaped control character");
+            if (c !== "\\") {
+                out += c;
+                continue;
+            }
+            const e = this.text[this.index++];
+            const simple = { '"': '"', "\\": "\\", "/": "/", b: "\b", f: "\f", n: "\n", r: "\r", t: "\t" };
+            if (e !== undefined && e in simple) {
+                out += simple[e];
+                continue;
+            }
+            if (e !== "u" || !/^[0-9a-fA-F]{4}$/.test(this.text.slice(this.index, this.index + 4)))
+                throw new SyntaxError("Invalid escape");
+            out += String.fromCharCode(parseInt(this.text.slice(this.index, this.index + 4), 16));
+            this.index += 4;
+        }
+        if (!validText(out))
+            throw new SyntaxError("Lone surrogate escape");
+        return out;
+    }
+    number() {
+        const match = /-?(?:0|[1-9][0-9]*)(\.[0-9]+)?([eE][+-]?[0-9]+)?/y;
+        match.lastIndex = this.index;
+        const found = match.exec(this.text);
+        if (found === null)
+            throw new SyntaxError("Invalid JSON value");
+        this.index = match.lastIndex;
+        // Selected schemas have no fractional numbers; fraction/exponent lexemes never satisfy an integer.
+        return found[1] !== undefined || found[2] !== undefined ? Number.NaN : Number(found[0]);
+    }
+    literal(word, value) {
+        if (this.text.slice(this.index, this.index + word.length) !== word)
+            throw new SyntaxError("Invalid JSON literal");
+        this.index += word.length;
+        return value;
+    }
+    space() {
+        while (this.text[this.index] === " " || this.text[this.index] === "\t" || this.text[this.index] === "\n" || this.text[this.index] === "\r")
+            this.index++;
+    }
+}
+function validText(value) {
+    for (const scalar of value) {
+        const point = scalar.codePointAt(0);
+        if (point >= 0xd800 && point <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+function inventoryRules(value) {
+    const files = value.files;
+    const seen = new Set();
+    let previous;
+    let total = 0n;
+    for (const file of files) {
+        const path = file.path;
+        const folded = path.toUpperCase();
+        if (path.length === 0 || folded === 'INVENTORY.JSON' || folded === 'SIGNATURE.JSON' || seen.has(folded) || (previous !== undefined && previous >= path))
+            return false;
+        for (const segment of path.split('/')) {
+            if (!/^[A-Za-z0-9_.-]+$/.test(segment) || segment === '.' || segment === '..' || segment.endsWith('.') || /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(segment))
+                return false;
+        }
+        const size = BigInt(file.size);
+        if (size > 134217728n)
+            return false;
+        total += size;
+        if (total > 1073741824n)
+            return false;
+        seen.add(folded);
+        previous = path;
+    }
+    return files.some(file => file.path === 'manifest.json');
+}

package/dist/shapes/gen/PartReceipt.d.ts

@@ -0,0 +1,21 @@
+export interface PartReceipt {
+    partNumber: number;
+    size: string;
+    sha256: string;
+    etag: string;
+}
+export declare function isPartReceipt(value: unknown): value is PartReceipt;
+/** The schema's declared UTF-8 document bound in bytes. */
+export declare const partReceiptJsonMaxBytes = 65536;
+/** Parses one strict PartReceipt document; refusal kinds match the C# codec. */
+export declare function tryParsePartReceiptJson(input: Uint8Array | string): {
+    ok: true;
+    value: PartReceipt;
+} | {
+    ok: false;
+    failure: "tooLarge" | "malformed" | "invalid";
+};
+/** Parses one strict PartReceipt document or throws an error carrying the refusal kind. */
+export declare function parsePartReceiptJson(input: Uint8Array | string): PartReceipt;
+/** Writes compact UTF-8 in schema property order and refuses output the schema rejects. */
+export declare function serializePartReceiptJson(value: PartReceipt): Uint8Array;

package/dist/shapes/gen/PartReceipt.js

@@ -0,0 +1,290 @@
+export function isPartReceipt(value) { return check0(value); }
+/** The schema's declared UTF-8 document bound in bytes. */
+export const partReceiptJsonMaxBytes = 65536;
+/** Parses one strict PartReceipt document; refusal kinds match the C# codec. */
+export function tryParsePartReceiptJson(input) {
+    const parsed = strictJson(input, 65536);
+    if (!parsed.ok)
+        return parsed;
+    return isPartReceipt(parsed.value) ? { ok: true, value: parsed.value } : { ok: false, failure: "invalid" };
+}
+/** Parses one strict PartReceipt document or throws an error carrying the refusal kind. */
+export function parsePartReceiptJson(input) {
+    const result = tryParsePartReceiptJson(input);
+    if (!result.ok)
+        throw Object.assign(new Error(`PartReceipt JSON refused: ${result.failure}.`), { failure: result.failure });
+    return result.value;
+}
+/** Writes compact UTF-8 in schema property order and refuses output the schema rejects. */
+export function serializePartReceiptJson(value) {
+    const bytes = new TextEncoder().encode(JSON.stringify(orderPartReceipt(value)));
+    const result = tryParsePartReceiptJson(bytes);
+    if (!result.ok)
+        throw Object.assign(new Error(`PartReceipt JSON refused: ${result.failure}.`), { failure: result.failure });
+    return bytes;
+}
+function orderPartReceipt(value) {
+    const out = {};
+    out["partNumber"] = value["partNumber"];
+    out["size"] = value["size"];
+    out["sha256"] = value["sha256"];
+    out["etag"] = value["etag"];
+    return out;
+}
+function check0(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "partNumber":
+                if (!check1(object[key]))
+                    return false;
+                break;
+            case "size":
+                if (!check2(object[key]))
+                    return false;
+                break;
+            case "sha256":
+                if (!check3(object[key]))
+                    return false;
+                break;
+            case "etag":
+                if (!check4(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "partNumber"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "size"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "sha256"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "etag"))
+        return false;
+    return true;
+}
+function check1(value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value))
+        return false;
+    if (value < 0)
+        return false;
+    if (value > 4294967295)
+        return false;
+    return true;
+}
+function check2(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ([...value].length > 20)
+        return false;
+    if ((new RegExp("^(0|[1-9][0-9]*)$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    if (BigInt(value) > 18446744073709551615n)
+        return false;
+    return true;
+}
+function check3(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[0-9a-f]{64}$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+function check4(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    return true;
+}
+/** Strict UTF-8 JSON: no BOM, comments, trailing commas or duplicate properties; depth <= 32; integer lexemes only. */
+function strictJson(input, maxBytes) {
+    let text;
+    if (typeof input === "string") {
+        if (!validText(input))
+            return { ok: false, failure: "malformed" };
+        if (new TextEncoder().encode(input).byteLength > maxBytes)
+            return { ok: false, failure: "tooLarge" };
+        text = input;
+    }
+    else {
+        if (input.byteLength > maxBytes)
+            return { ok: false, failure: "tooLarge" };
+        try {
+            text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(input);
+        }
+        catch {
+            return { ok: false, failure: "malformed" };
+        }
+    }
+    try {
+        return { ok: true, value: new StrictJsonReader(text).document() };
+    }
+    catch {
+        return { ok: false, failure: "malformed" };
+    }
+}
+class StrictJsonReader {
+    text;
+    index = 0;
+    constructor(text) {
+        this.text = text;
+    }
+    document() {
+        this.space();
+        const value = this.value(0);
+        this.space();
+        if (this.index !== this.text.length)
+            throw new SyntaxError("Trailing JSON content");
+        return value;
+    }
+    value(depth) {
+        switch (this.text[this.index]) {
+            case "{": return this.object(depth + 1);
+            case "[": return this.array(depth + 1);
+            case '"': return this.string();
+            case "t": return this.literal("true", true);
+            case "f": return this.literal("false", false);
+            case "n": return this.literal("null", null);
+            default: return this.number();
+        }
+    }
+    object(depth) {
+        if (depth > 32)
+            throw new SyntaxError("JSON depth exceeded");
+        this.index++;
+        const out = {};
+        const keys = new Set();
+        this.space();
+        if (this.text[this.index] === "}") {
+            this.index++;
+            return out;
+        }
+        for (;;) {
+            this.space();
+            if (this.text[this.index] !== '"')
+                throw new SyntaxError("Expected property name");
+            const key = this.string();
+            if (keys.has(key))
+                throw new SyntaxError("Duplicate JSON property");
+            keys.add(key);
+            this.space();
+            if (this.text[this.index++] !== ":")
+                throw new SyntaxError("Expected colon");
+            this.space();
+            // defineProperty keeps names such as __proto__ as ordinary own properties.
+            Object.defineProperty(out, key, { value: this.value(depth), enumerable: true, writable: true, configurable: true });
+            this.space();
+            const next = this.text[this.index++];
+            if (next === "}")
+                return out;
+            if (next !== ",")
+                throw new SyntaxError("Expected comma");
+        }
+    }
+    array(depth) {
+        if (depth > 32)
+            throw new SyntaxError("JSON depth exceeded");
+        this.index++;
+        const out = [];
+        this.space();
+        if (this.text[this.index] === "]") {
+            this.index++;
+            return out;
+        }
+        for (;;) {
+            this.space();
+            out.push(this.value(depth));
+            this.space();
+            const next = this.text[this.index++];
+            if (next === "]")
+                return out;
+            if (next !== ",")
+                throw new SyntaxError("Expected comma");
+        }
+    }
+    string() {
+        this.index++;
+        let out = "";
+        for (;;) {
+            const c = this.text[this.index++];
+            if (c === undefined)
+                throw new SyntaxError("Unterminated string");
+            if (c === '"')
+                break;
+            if (c < " ")
+                throw new SyntaxError("Unescaped control character");
+            if (c !== "\\") {
+                out += c;
+                continue;
+            }
+            const e = this.text[this.index++];
+            const simple = { '"': '"', "\\": "\\", "/": "/", b: "\b", f: "\f", n: "\n", r: "\r", t: "\t" };
+            if (e !== undefined && e in simple) {
+                out += simple[e];
+                continue;
+            }
+            if (e !== "u" || !/^[0-9a-fA-F]{4}$/.test(this.text.slice(this.index, this.index + 4)))
+                throw new SyntaxError("Invalid escape");
+            out += String.fromCharCode(parseInt(this.text.slice(this.index, this.index + 4), 16));
+            this.index += 4;
+        }
+        if (!validText(out))
+            throw new SyntaxError("Lone surrogate escape");
+        return out;
+    }
+    number() {
+        const match = /-?(?:0|[1-9][0-9]*)(\.[0-9]+)?([eE][+-]?[0-9]+)?/y;
+        match.lastIndex = this.index;
+        const found = match.exec(this.text);
+        if (found === null)
+            throw new SyntaxError("Invalid JSON value");
+        this.index = match.lastIndex;
+        // Selected schemas have no fractional numbers; fraction/exponent lexemes never satisfy an integer.
+        return found[1] !== undefined || found[2] !== undefined ? Number.NaN : Number(found[0]);
+    }
+    literal(word, value) {
+        if (this.text.slice(this.index, this.index + word.length) !== word)
+            throw new SyntaxError("Invalid JSON literal");
+        this.index += word.length;
+        return value;
+    }
+    space() {
+        while (this.text[this.index] === " " || this.text[this.index] === "\t" || this.text[this.index] === "\n" || this.text[this.index] === "\r")
+            this.index++;
+    }
+}
+function validText(value) {
+    for (const scalar of value) {
+        const point = scalar.codePointAt(0);
+        if (point >= 0xd800 && point <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+function inventoryRules(value) {
+    const files = value.files;
+    const seen = new Set();
+    let previous;
+    let total = 0n;
+    for (const file of files) {
+        const path = file.path;
+        const folded = path.toUpperCase();
+        if (path.length === 0 || folded === 'INVENTORY.JSON' || folded === 'SIGNATURE.JSON' || seen.has(folded) || (previous !== undefined && previous >= path))
+            return false;
+        for (const segment of path.split('/')) {
+            if (!/^[A-Za-z0-9_.-]+$/.test(segment) || segment === '.' || segment === '..' || segment.endsWith('.') || /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(segment))
+                return false;
+        }
+        const size = BigInt(file.size);
+        if (size > 134217728n)
+            return false;
+        total += size;
+        if (total > 1073741824n)
+            return false;
+        seen.add(folded);
+        previous = path;
+    }
+    return files.some(file => file.path === 'manifest.json');
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@arcforges/api-client",
+  "version": "1.0.0-ci.101.1",
+  "description": "ArcForges public gRPC-Web client entry point; initial Hello World example.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArcForges/Contracts.git",
+    "directory": "src/public/ts/api-client"
+  },
+  "homepage": "https://github.com/ArcForges/Contracts#readme",
+  "bugs": {
+    "url": "https://github.com/ArcForges/Contracts/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./build-identity": "./build-identity.json"
+  },
+  "files": [
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "build-identity.json",
+    "contracts.binpb",
+    "dist",
+    "sbom.cdx.json",
+    "schemas",
+    "source.json"
+  ],
+  "dependencies": {
+    "@arcforges/proto": "1.0.0-ci.101.1",
+    "@bufbuild/protobuf": "2.15.0",
+    "@connectrpc/connect": "2.2.0",
+    "@connectrpc/connect-web": "2.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "arcforges": {
+    "licenceBoundary": "Apache",
+    "contractAccess": "public"
+  }
+}