Skip to content

@codesoul-co/hypha-adapters-local / local-artifact-manifest

Using this module

Use the Local artifact manifest module for using the public contracts and operations for this capability boundary. It exports 4 functions, 1 interface.

Import from the package entrypoint

ts
import {
  deleteLocalArtifactManifest,
  listLocalArtifactManifests,
  readLocalArtifactManifest,
  writeLocalArtifactManifest,
} from '@codesoul-co/hypha-adapters-local';

import type {
  LocalArtifactObjectManifest,
} from '@codesoul-co/hypha-adapters-local';

Usage patterns

  • Use the 1 type/interface export as static contracts in application code, adapters, or tests. Import them with import type; they do not exist at runtime.
  • The module exposes 4 functions as direct operation entrypoints. Every overload, required/optional parameter, and return type is documented below.

Public exports

SymbolKindSignatureDescription
deleteLocalArtifactManifestfunctiondeleteLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<void>Delete Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.
listLocalArtifactManifestsfunctionlistLocalArtifactManifests(paths: LocalArtifactStorePaths): Promise<LocalArtifactObjectManifest[]>List Local Artifact Manifests function with 1 public call signature; parameters and return types are listed below.
readLocalArtifactManifestfunctionreadLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<LocalArtifactObjectManifest | null>Read Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.
writeLocalArtifactManifestfunctionwriteLocalArtifactManifest(paths: LocalArtifactStorePaths, manifest: LocalArtifactObjectManifest, options?: { ifAbsent?: boolean; }): Promise<void>Write Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.
LocalArtifactObjectManifestinterfaceinterface LocalArtifactObjectManifestLocal Artifact Object Manifest interface with 8 public fields or methods.

deleteLocalArtifactManifest

Delete Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.

  • Kind: function
  • Import: import { deleteLocalArtifactManifest } from '@codesoul-co/hypha-adapters-local';
  • Source module: local-artifact-manifest

Declaration

text
export declare function deleteLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<void>;

Call signature

text
deleteLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<void>

Parameters

ParameterTypeRequiredDescription
pathsLocalArtifactStorePathsYesRequired parameter; accepted values are defined by the type column.
objectKeystringYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: Promise<void>
  • Description: The return contract is defined by the type shown above.

listLocalArtifactManifests

List Local Artifact Manifests function with 1 public call signature; parameters and return types are listed below.

  • Kind: function
  • Import: import { listLocalArtifactManifests } from '@codesoul-co/hypha-adapters-local';
  • Source module: local-artifact-manifest

Declaration

text
export declare function listLocalArtifactManifests(paths: LocalArtifactStorePaths): Promise<LocalArtifactObjectManifest[]>;

Call signature

text
listLocalArtifactManifests(paths: LocalArtifactStorePaths): Promise<LocalArtifactObjectManifest[]>

Parameters

ParameterTypeRequiredDescription
pathsLocalArtifactStorePathsYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: Promise<LocalArtifactObjectManifest[]>
  • Description: The return contract is defined by the type shown above.

readLocalArtifactManifest

Read Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.

  • Kind: function
  • Import: import { readLocalArtifactManifest } from '@codesoul-co/hypha-adapters-local';
  • Source module: local-artifact-manifest

Declaration

text
export declare function readLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<LocalArtifactObjectManifest | null>;

Call signature

text
readLocalArtifactManifest(paths: LocalArtifactStorePaths, objectKey: string): Promise<LocalArtifactObjectManifest | null>

Parameters

ParameterTypeRequiredDescription
pathsLocalArtifactStorePathsYesRequired parameter; accepted values are defined by the type column.
objectKeystringYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: Promise<LocalArtifactObjectManifest>
  • Description: The return contract is defined by the type shown above.

writeLocalArtifactManifest

Write Local Artifact Manifest function with 1 public call signature; parameters and return types are listed below.

  • Kind: function
  • Import: import { writeLocalArtifactManifest } from '@codesoul-co/hypha-adapters-local';
  • Source module: local-artifact-manifest

Declaration

text
export declare function writeLocalArtifactManifest(paths: LocalArtifactStorePaths, manifest: LocalArtifactObjectManifest, options?: {
    ifAbsent?: boolean;
}): Promise<void>;

Call signature

text
writeLocalArtifactManifest(paths: LocalArtifactStorePaths, manifest: LocalArtifactObjectManifest, options?: { ifAbsent?: boolean; }): Promise<void>

Parameters

ParameterTypeRequiredDescription
pathsLocalArtifactStorePathsYesRequired parameter; accepted values are defined by the type column.
manifestLocalArtifactObjectManifestYesRequired parameter; accepted values are defined by the type column.
options{ ifAbsent?: boolean; }NoOptional parameter; accepted values are defined by the type column.

Returns

  • Type: Promise<void>
  • Description: The return contract is defined by the type shown above.

LocalArtifactObjectManifest

Local Artifact Object Manifest interface with 8 public fields or methods.

  • Kind: interface
  • Import: import type { LocalArtifactObjectManifest } from '@codesoul-co/hypha-adapters-local';
  • Source module: local-artifact-manifest

Declaration

text
export interface LocalArtifactObjectManifest {
    schemaVersion: 1;
    objectKey: string;
    contentHash: string;
    sizeBytes: number;
    mimeType?: string;
    etag: string;
    metadata?: Record<string, string>;
    lastModifiedAt: string;
}

Contract members

MemberKindSignatureDescription
contentHashpropertycontentHash: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
etagpropertyetag: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
lastModifiedAtpropertylastModifiedAt: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
metadatapropertymetadata?: Record<string, string>Public property; its type, readonly modifier and optionality are shown in the signature.
mimeTypepropertymimeType?: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
objectKeypropertyobjectKey: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
schemaVersionpropertyschemaVersion: 1Public property; its type, readonly modifier and optionality are shown in the signature.
sizeBytespropertysizeBytes: numberPublic property; its type, readonly modifier and optionality are shown in the signature.