flagon-io/g1t

public

117 lines5,096 bytesCode Blame

Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.

Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member13h ago	1	import type { AuditSurface } from "./audit";
	2	import type { User, Viewer } from "./identity";
	3	import type { Result } from "./result";
	4
	5	/**
	6	* The packages service: the registries a workspace publishes to and
	7	* installs from, beside its code (docs/PACKAGES.md). Container images
	8	* first, on `g1t.sh/v2/`. Mirrors `crates/contracts/src/packages.rs`.
	9	*
	10	* A package linked to a repository has its visibility and roles (Read
	11	* pulls, Write publishes, Admin deletes and changes settings); an unlinked
	12	* one is its workspace's: members by the base permission, owners delete.
	13	*/
	14
	15	/** Which registry a package is in. */
	16	export const ECOSYSTEMS = ["container", "npm", "composer", "cargo", "go"] as const;
	17	export type Ecosystem = (typeof ECOSYSTEMS)[number];
	18
	19	export type PackageVisibility = "public" \| "private";
	20
	21	export type LinkedRepo = { id: string; namespace: string; name: string };
	22
	23	/** A package as listings show it. */
	24	export type PackageSummary = {
	25	id: string;
	26	workspace: string;
	27	ecosystem: Ecosystem;
	28	/** Without the workspace: `web` for `g1t.sh/acme/web`. */
	29	name: string;
	30	/** What a client is given: `g1t.sh/acme/web` for a container image. */
	31	address: string;
	32	/** Linked packages follow their repository's visibility. */
	33	visibility: PackageVisibility;
	34	repo: LinkedRepo \| null;
	35	description: string \| null;
	36	versions: number;
	37	/** The newest version's tag (`latest` when it has one) or version. */
	38	latest: string \| null;
	39	/** Bytes its versions hold, each file counted once. */
	40	size: number;
	41	/** Pulls and installs, counted approximately. */
	42	downloads: number;
	43	created_at: string;
	44	updated_at: string;
	45	};
	46
	47	/** One version: for a container image, one manifest, by digest. */
	48	export type PackageVersion = {
	49	id: string;
	50	version: string;
	51	digest: string;
	52	size: number;
	53	media_type: string \| null;
	54	/** For an OCI artifact: what it is, such as a signature or an SBOM. */
	55	artifact_type: string \| null;
	56	/** For an artifact attached to another version: that version's digest. */
	57	subject: string \| null;
	58	/** For an image index: the platforms it holds, such as `linux/amd64`. */
	59	platforms: string[];
	60	tags: string[];
	61	published_by: string \| null;
	62	published_at: string;
npm on g1t.sh: publish and install @<workspace>/<name> with the npm CLI and a g1t token12h ago	63	/** npm: why the version should no longer be used, when it is deprecated. */
	64	deprecated?: string \| null;
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member13h ago	65	};
	66
	67	export type PackageTag = { tag: string; digest: string; updated_at: string };
	68
	69	/** What the viewer may do with a package. `admin`: change its visibility and link. */
	70	export type PackagePermissions = { pull: boolean; push: boolean; delete: boolean; admin: boolean };
	71
	72	export type PackageDetail = {
	73	package: PackageSummary;
	74	/** Newest first. */
	75	versions: PackageVersion[];
	76	tags: PackageTag[];
	77	permissions: PackagePermissions;
npm on g1t.sh: publish and install @<workspace>/<name> with the npm CLI and a g1t token12h ago	78	/** The package's README, as markdown: npm's, from its latest version. */
	79	readme?: string \| null;
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member13h ago	80	};
	81
	82	/** What a workspace's packages hold, for billing: each file once, public when any public package uses it. */
	83	export type PackageStorage = { public_bytes: number; private_bytes: number };
	84
	85	/** `storage_all`: every workspace with packages, by workspace, for billing's daily measure. */
	86	export type WorkspacePackageStorage = { workspace: string; public_bytes: number; private_bytes: number };
	87
	88	export type PackageFilter = { ecosystem?: Ecosystem \| null; repoId?: string \| null; query?: string \| null };
	89
	90	export type PackageChange = {
	91	visibility?: PackageVisibility;
	92	/** A repository of the package's workspace, by name. */
	93	link?: string;
	94	/** Take the link away. */
	95	unlink?: boolean;
	96	};
	97
	98	export type PackagesApi = {
	99	/** The workspace's packages the viewer may pull, newest first. */
	100	list(workspace: string, viewer: Viewer, filter?: PackageFilter): Promise<Result<PackageSummary[]>>;
	101	/** Not found when the viewer may not pull it. */
	102	get(workspace: string, ecosystem: Ecosystem, name: string, viewer: Viewer): Promise<Result<PackageDetail>>;
	103	/** A version by version, digest or tag; its tags go with it. */
	104	deleteVersion(actor: User, workspace: string, ecosystem: Ecosystem, name: string, version: string, surface?: AuditSurface): Promise<Result<null>>;
	105	deletePackage(actor: User, workspace: string, ecosystem: Ecosystem, name: string, surface?: AuditSurface): Promise<Result<null>>;
	106	/** Needs Admin. A linked package's visibility is its repository's. */
	107	set(actor: User, workspace: string, ecosystem: Ecosystem, name: string, change: PackageChange, surface?: AuditSurface): Promise<Result<PackageSummary>>;
	108	/** For billing. */
	109	storage(workspace: string): Promise<PackageStorage>;
	110	/** For billing: every workspace with packages, from one query. */
	111	storageAll(): Promise<WorkspacePackageStorage[]>;
Composer from the workspace's own repositories, and go get from g1t.sh11h ago	112	/** Read a repository's Composer package again now, as a push would. Whether it is one. */
	113	syncComposer(repoId: string): Promise<boolean>;
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member13h ago	114	};
	115
	116	/** The RPC method behind each call, as the Rust service names them. */
Composer from the workspace's own repositories, and go get from g1t.sh11h ago	117	export const PACKAGES_METHODS = ["list_packages", "get_package", "delete_version", "delete_package", "set_package", "storage", "storage_all", "sync_composer"] as const;