@codybrom/denim 1.3.6 → 2.0.1

package/.github/workflows/publish.yml

@@ -1,9 +1,16 @@
 name: Publish
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - main
+    paths:
+      - "src/**"
+      - "mod.ts"
+      - "deno.json"
+      - "deno.lock"
+      - "package.json"
 
 jobs:
   publish:
@@ -14,18 +21,21 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+
+      - uses: denoland/setup-deno@v2
+
+      - name: Run checks
+        run: deno task check && deno task lint && deno task test
 
       - name: Publish package to JSR
-        run: npx jsr publish
-        
+        run: deno publish
+
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
-          registry-url: 'https://registry.npmjs.org'
+          node-version: "24.x"
+          registry-url: "https://registry.npmjs.org"
 
       - name: Publish package to NPM
         run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.vscode/settings.json

@@ -1,11 +1,36 @@
 {
-  "gpt-context-generator.detectedFileExtensions": [
-    "js",
-    "jsx",
-    "ts",
-    "tsx",
-    "mdx",
-    "json",
-    "md"
-  ]
+	"deno.enable": true,
+	"deno.lint": true,
+	"editor.defaultFormatter": "denoland.vscode-deno",
+	"editor.formatOnSave": true,
+	"editor.codeActionsOnSave": {
+		"source.organizeImports": "explicit"
+	},
+	"explorer.fileNesting.enabled": true,
+	"explorer.fileNesting.patterns": {
+		"*.ts": "${capture}.test.ts, ${capture}.d.ts",
+		"deno.json": "deno.lock"
+	},
+	"files.exclude": {
+		"**/.DS_Store": true
+	},
+	"[typescript]": {
+		"editor.defaultFormatter": "denoland.vscode-deno"
+	},
+	"[typescriptreact]": {
+		"editor.defaultFormatter": "denoland.vscode-deno"
+	},
+	"[json]": {
+		"editor.defaultFormatter": "denoland.vscode-deno"
+	},
+	"[jsonc]": {
+		"editor.defaultFormatter": "denoland.vscode-deno"
+	},
+	"[markdown]": {
+		"editor.defaultFormatter": "denoland.vscode-deno"
+	},
+	"markdownlint.config": {
+		"MD010": false,
+		"MD024": { "siblings_only": true }
+	}
 }

package/CHANGELOG.md

@@ -0,0 +1,137 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.1] - 2026-04-17
+
+### Fixed
+
+- `searchLocations()` now sends the query string as the `q` URL parameter.
+  Meta's `/location_search` endpoint requires `q`; the prior `query` name was
+  silently ignored, causing proximity-only results regardless of the search
+  string.
+
+## [2.0.0] - 2026-02-08
+
+### Changed
+
+- Response types now use snake_case to match the actual API. In v1, fields like
+  `hasReplies` on `ThreadsPost` were camelCase but never populated because the
+  API returns `has_replies`. Input types still use camelCase.
+- `PublishingLimit` fields are optional (the API only returns requested fields)
+- `MockThreadsAPI` class renamed to `MockThreadsAPIImpl`
+- `createThreadsContainer` now always returns a `string` (container ID). The
+  previous `string | { id, permalink }` return type is removed; use
+  `publishThreadsContainer` with `getPermalink: true` to get the permalink.
+- Updated to Deno 2 conventions and `@std/assert` ^1.0.18
+
+### Added
+
+- 22 new functions covering profiles, replies, insights, search, locations,
+  OAuth, token management, oEmbed, repost, and delete (see readme for the full
+  list)
+- 11 new post options: polls, GIFs, ghost posts, spoilers, text attachments,
+  replies, quotes, topic tags, location tags
+- Optional `fields` parameter on retrieval, search, and profile lookup functions
+- `reverse` parameter on `getReplies()` and `getConversation()`
+- `ResponseMediaType` for response-only media type values (`TEXT_POST`,
+  `CAROUSEL_ALBUM`, `REPOST_FACADE`, `AUDIO`)
+- Validation for new post parameters
+
+### Removed
+
+- `serveRequests()` edge function handler and `handleRequest` server
+- `THREADS_API_BASE_URL` constant from public exports
+
+## [1.3.6] - 2024-09-23
+
+### Fixed
+
+- Permalink retrieval in `publishThreadsContainer`
+
+## [1.3.5] - 2024-09-23
+
+### Added
+
+- `getThreadsList` function for retrieving a user's threads with pagination
+- `getSingleThread` function for retrieving a single thread by ID
+- `getPermalink` option on `publishThreadsContainer` to return permalink with
+  the published post ID
+- `MockThreadsAPI` interface and mock implementation for testing
+- `ThreadsPost`, `ThreadsListResponse`, and `PublishingLimit` types
+
+### Changed
+
+- Extracted types into dedicated `types.ts` module
+- Refactored all API functions to support mock API injection via `getAPI()`
+- Updated edge function example
+
+## [1.3.1] - 2024-09-13
+
+### Fixed
+
+- Media item container creation for video posts
+
+## [1.3.0] - 2024-09-13
+
+### Added
+
+- `checkContainerStatus` helper to poll container status after publishing
+- Status polling loop in `publishThreadsContainer` — waits for `PUBLISHED` or
+  `FINISHED` status before returning
+
+### Changed
+
+- Refactored `createThreadsContainer` to use a switch statement for
+  media-type-specific parameter handling
+- Videos are now posted directly instead of being wrapped in a carousel
+
+## [1.2.0] - 2024-09-13
+
+### Removed
+
+- `checkHealth` function (unused Threads API endpoint)
+- `Threads API.md` reference file
+
+## [1.1.0] - 2024-09-13
+
+### Added
+
+- `CAROUSEL` media type support
+- `createCarouselItem` function for building carousel posts
+- `getPublishingLimit` function for checking rate limit usage
+- `checkHealth` function for Threads API health checks
+- Post options: `altText`, `linkAttachment`, `allowlistedCountryCodes`,
+  `replyControl`, `children`
+- Input validation for media type and property combinations
+- `package.json` for npm publishing
+- Comprehensive test suite
+
+## [1.0.2] - 2024-08-01
+
+### Changed
+
+- Updated readme with JSR badges and `deno add` install instructions
+- Switched import examples from raw GitHub URL to JSR registry
+
+## [1.0.1] - 2024-08-01
+
+### Added
+
+- JSDoc comments on all public exports
+- MIT license
+
+## [1.0.0] - 2024-08-01
+
+### Added
+
+- `createThreadsContainer` function for creating media containers (TEXT, IMAGE,
+  VIDEO)
+- `publishThreadsContainer` function for publishing containers
+- `ThreadsPostRequest` type
+- `serveRequests` edge function handler
+- GitHub Actions workflow for publishing to JSR

package/deno.json

@@ -1,9 +1,23 @@
 {
-    "name": "@codybrom/denim",
-    "version": "1.3.6",
-    "description": "A Deno function for posting to Threads.",
-    "entry": "./mod.ts",
-    "exports": {
-        ".": "./mod.ts"
-    }
-}
+	"name": "@codybrom/denim",
+	"version": "2.0.1",
+	"description": "A Deno/TypeScript library for the Threads API",
+	"exports": {
+		".": "./mod.ts"
+	},
+	"imports": {
+		"@codybrom/denim": "./mod.ts",
+		"@std/assert": "jsr:@std/assert@^1.0.18"
+	},
+	"tasks": {
+		"test": "deno test",
+		"check": "deno check mod.ts",
+		"lint": "deno lint",
+		"fmt": "deno fmt",
+		"fmt:check": "deno fmt --check"
+	},
+	"fmt": {
+		"useTabs": true,
+		"singleQuote": false
+	}
+}

package/deno.lock

@@ -1,65 +1,23 @@
 {
-  "version": "3",
-  "packages": {
-    "specifiers": {
-      "jsr:@std/assert@1": "jsr:@std/assert@1.0.1",
-      "jsr:@std/internal@^1.0.1": "jsr:@std/internal@1.0.1"
+  "version": "5",
+  "specifiers": {
+    "jsr:@std/assert@^1.0.18": "1.0.18",
+    "jsr:@std/internal@^1.0.12": "1.0.12"
+  },
+  "jsr": {
+    "@std/assert@1.0.18": {
+      "integrity": "270245e9c2c13b446286de475131dc688ca9abcd94fc5db41d43a219b34d1c78",
+      "dependencies": [
+        "jsr:@std/internal"
+      ]
     },
-    "jsr": {
-      "@std/assert@1.0.1": {
-        "integrity": "13590ef8e5854f59e4ad252fd987e83239a1bf1f16cb9c69c1d123ebb807a75b",
-        "dependencies": [
-          "jsr:@std/internal@^1.0.1"
-        ]
-      },
-      "@std/internal@1.0.1": {
-        "integrity": "6f8c7544d06a11dd256c8d6ba54b11ed870aac6c5aeafff499892662c57673e6"
-      }
+    "@std/internal@1.0.12": {
+      "integrity": "972a634fd5bc34b242024402972cd5143eac68d8dffaca5eaa4dba30ce17b027"
     }
   },
-  "redirects": {
-    "https://deno.land/std/testing/asserts.ts": "https://deno.land/std@0.224.0/testing/asserts.ts"
-  },
-  "remote": {
-    "https://deno.land/std@0.153.0/fmt/colors.ts": "ff7dc9c9f33a72bd48bc24b21bbc1b4545d8494a431f17894dbc5fe92a938fc4",
-    "https://deno.land/std@0.153.0/testing/_diff.ts": "141f978a283defc367eeee3ff7b58aa8763cf7c8e0c585132eae614468e9d7b8",
-    "https://deno.land/std@0.153.0/testing/_format.ts": "cd11136e1797791045e639e9f0f4640d5b4166148796cad37e6ef75f7d7f3832",
-    "https://deno.land/std@0.153.0/testing/_test_suite.ts": "2d07073d5460a4e3ec50c55ae822cd9bd136926d7363091379947fef9c73c3e4",
-    "https://deno.land/std@0.153.0/testing/asserts.ts": "d6595cfc330b4233546a047a0d7d57940771aa9d97a172ceb91e84ae6200b3af",
-    "https://deno.land/std@0.153.0/testing/bdd.ts": "35060cefd9cc21b414f4d89453b3551a3d52ec50aeff25db432503c5485b2f72",
-    "https://deno.land/std@0.224.0/assert/_constants.ts": "a271e8ef5a573f1df8e822a6eb9d09df064ad66a4390f21b3e31f820a38e0975",
-    "https://deno.land/std@0.224.0/assert/assert.ts": "09d30564c09de846855b7b071e62b5974b001bb72a4b797958fe0660e7849834",
-    "https://deno.land/std@0.224.0/assert/assert_almost_equals.ts": "9e416114322012c9a21fa68e187637ce2d7df25bcbdbfd957cd639e65d3cf293",
-    "https://deno.land/std@0.224.0/assert/assert_array_includes.ts": "14c5094471bc8e4a7895fc6aa5a184300d8a1879606574cb1cd715ef36a4a3c7",
-    "https://deno.land/std@0.224.0/assert/assert_equals.ts": "3bbca947d85b9d374a108687b1a8ba3785a7850436b5a8930d81f34a32cb8c74",
-    "https://deno.land/std@0.224.0/assert/assert_exists.ts": "43420cf7f956748ae6ed1230646567b3593cb7a36c5a5327269279c870c5ddfd",
-    "https://deno.land/std@0.224.0/assert/assert_false.ts": "3e9be8e33275db00d952e9acb0cd29481a44fa0a4af6d37239ff58d79e8edeff",
-    "https://deno.land/std@0.224.0/assert/assert_greater.ts": "5e57b201fd51b64ced36c828e3dfd773412c1a6120c1a5a99066c9b261974e46",
-    "https://deno.land/std@0.224.0/assert/assert_greater_or_equal.ts": "9870030f997a08361b6f63400273c2fb1856f5db86c0c3852aab2a002e425c5b",
-    "https://deno.land/std@0.224.0/assert/assert_instance_of.ts": "e22343c1fdcacfaea8f37784ad782683ec1cf599ae9b1b618954e9c22f376f2c",
-    "https://deno.land/std@0.224.0/assert/assert_is_error.ts": "f856b3bc978a7aa6a601f3fec6603491ab6255118afa6baa84b04426dd3cc491",
-    "https://deno.land/std@0.224.0/assert/assert_less.ts": "60b61e13a1982865a72726a5fa86c24fad7eb27c3c08b13883fb68882b307f68",
-    "https://deno.land/std@0.224.0/assert/assert_less_or_equal.ts": "d2c84e17faba4afe085e6c9123a63395accf4f9e00150db899c46e67420e0ec3",
-    "https://deno.land/std@0.224.0/assert/assert_match.ts": "ace1710dd3b2811c391946954234b5da910c5665aed817943d086d4d4871a8b7",
-    "https://deno.land/std@0.224.0/assert/assert_not_equals.ts": "78d45dd46133d76ce624b2c6c09392f6110f0df9b73f911d20208a68dee2ef29",
-    "https://deno.land/std@0.224.0/assert/assert_not_instance_of.ts": "3434a669b4d20cdcc5359779301a0588f941ffdc2ad68803c31eabdb4890cf7a",
-    "https://deno.land/std@0.224.0/assert/assert_not_match.ts": "df30417240aa2d35b1ea44df7e541991348a063d9ee823430e0b58079a72242a",
-    "https://deno.land/std@0.224.0/assert/assert_not_strict_equals.ts": "37f73880bd672709373d6dc2c5f148691119bed161f3020fff3548a0496f71b8",
-    "https://deno.land/std@0.224.0/assert/assert_object_match.ts": "411450fd194fdaabc0089ae68f916b545a49d7b7e6d0026e84a54c9e7eed2693",
-    "https://deno.land/std@0.224.0/assert/assert_rejects.ts": "4bee1d6d565a5b623146a14668da8f9eb1f026a4f338bbf92b37e43e0aa53c31",
-    "https://deno.land/std@0.224.0/assert/assert_strict_equals.ts": "b4f45f0fd2e54d9029171876bd0b42dd9ed0efd8f853ab92a3f50127acfa54f5",
-    "https://deno.land/std@0.224.0/assert/assert_string_includes.ts": "496b9ecad84deab72c8718735373feb6cdaa071eb91a98206f6f3cb4285e71b8",
-    "https://deno.land/std@0.224.0/assert/assert_throws.ts": "c6508b2879d465898dab2798009299867e67c570d7d34c90a2d235e4553906eb",
-    "https://deno.land/std@0.224.0/assert/assertion_error.ts": "ba8752bd27ebc51f723702fac2f54d3e94447598f54264a6653d6413738a8917",
-    "https://deno.land/std@0.224.0/assert/equal.ts": "bddf07bb5fc718e10bb72d5dc2c36c1ce5a8bdd3b647069b6319e07af181ac47",
-    "https://deno.land/std@0.224.0/assert/fail.ts": "0eba674ffb47dff083f02ced76d5130460bff1a9a68c6514ebe0cdea4abadb68",
-    "https://deno.land/std@0.224.0/assert/mod.ts": "48b8cb8a619ea0b7958ad7ee9376500fe902284bb36f0e32c598c3dc34cbd6f3",
-    "https://deno.land/std@0.224.0/assert/unimplemented.ts": "8c55a5793e9147b4f1ef68cd66496b7d5ba7a9e7ca30c6da070c1a58da723d73",
-    "https://deno.land/std@0.224.0/assert/unreachable.ts": "5ae3dbf63ef988615b93eb08d395dda771c96546565f9e521ed86f6510c29e19",
-    "https://deno.land/std@0.224.0/fmt/colors.ts": "508563c0659dd7198ba4bbf87e97f654af3c34eb56ba790260f252ad8012e1c5",
-    "https://deno.land/std@0.224.0/internal/diff.ts": "6234a4b493ebe65dc67a18a0eb97ef683626a1166a1906232ce186ae9f65f4e6",
-    "https://deno.land/std@0.224.0/internal/format.ts": "0a98ee226fd3d43450245b1844b47003419d34d210fa989900861c79820d21c2",
-    "https://deno.land/std@0.224.0/internal/mod.ts": "534125398c8e7426183e12dc255bb635d94e06d0f93c60a297723abe69d3b22e",
-    "https://deno.land/std@0.224.0/testing/asserts.ts": "d0cdbabadc49cc4247a50732ee0df1403fdcd0f95360294ad448ae8c240f3f5c"
+  "workspace": {
+    "dependencies": [
+      "jsr:@std/assert@^1.0.18"
+    ]
   }
 }